> ## Documentation Index
> Fetch the complete documentation index at: https://typesafe-sdk-go.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples

> Runnable programs in the repo

All examples live under [examples/](https://github.com/atharvamhaske/typesafe-sdk-go/tree/main/examples) and run with a real API key.

## SystemOne

```bash theme={null}
TYPESAFE_API_KEY=... go run ./examples/systemone
```

Asks all three question types (Choice, Score, Noul) about a support message and prints the typed answers plus token usage.

```console theme={null}
category: billing (confidence 1.00)
urgency:  1.00
is_dupe:  0.66
usage:    381 in / 64 out
```

## ListModels

```bash theme={null}
TYPESAFE_API_KEY=... go run ./examples/listmodels
```

Prints every model the API currently serves, with its release date and description.

## Common Jev patterns

These three Go examples follow patterns that show up repeatedly across the Jev community: a spam classifier, a PR labeler, and a game move picker. Each also links a few personal-favorite projects using the same pattern in other languages. Those links are unrelated to this Go SDK, added only because they're fun to see the pattern working elsewhere.

<Card title="awesome-jev" icon="github" href="https://github.com/hellogumbo/awesome-jev">
  Community directory of 800+ Jev projects. Every linked project below was found there — credit to its maintainers and contributors for cataloging them.
</Card>

### Spam filter

```bash theme={null}
TYPESAFE_API_KEY=... go run ./examples/spamfilter
```

A `Noul` question per message, thresholded in code.

<sub>Not related to this Go SDK, just a personal-favorite Jev use case: same shape as moderation and antispam bots like [Jev-Moderation-Bot](https://github.com/brainstormity/Jev-Moderation-Bot) or [scam-shield](https://github.com/ShupingR/scam-shield).</sub>

<iframe src="https://scam-shield-seven-ecru.vercel.app" title="scam-shield live demo" loading="lazy" sandbox="allow-scripts allow-same-origin allow-forms allow-popups" style={{ width: "100%", height: "500px", border: "1px solid var(--gray-a6, #33333340)", borderRadius: "8px" }} />

<sub>Live third-party demo, embedded from [scam-shield-seven-ecru.vercel.app](https://scam-shield-seven-ecru.vercel.app). Not affiliated with this SDK.</sub>

### PR labeler

```bash theme={null}
TYPESAFE_API_KEY=... go run ./examples/prlabel
```

A `Choice` question over a diff, labeling its conceptual scope (security, feature, refactor, docs) instead of counting changed lines.

<sub>Not related to this Go SDK, just a personal-favorite Jev use case: same pattern as [jev-pr-labeler](https://github.com/1jehuang/jev-pr-labeler) and [commit-miner](https://github.com/devanshbatham/commit-miner).</sub>

### Game move picker

```bash theme={null}
TYPESAFE_API_KEY=... go run ./examples/gamemove
```

The game engine owns state and rules; one `Choice` question per tick picks the move.

<sub>Not related to this Go SDK, just personal-favorite Jev use cases: the pattern behind dozens of Jev-plays-a-game demos, including [jev-tetris](https://github.com/trungdq88/jev-tetris) and [Jev Pac-Man](https://jev-pacman.ephraimduncan.com).</sub>

<Tabs>
  <Tab title="jev-tetris">
    <iframe src="https://jev-tetris.vercel.app" title="jev-tetris live demo" loading="lazy" sandbox="allow-scripts allow-same-origin allow-forms allow-popups" style={{ width: "100%", height: "500px", border: "1px solid var(--gray-a6, #33333340)", borderRadius: "8px" }} />
  </Tab>

  <Tab title="Jev Pac-Man">
    <iframe src="https://jev-pacman.ephraimduncan.com" title="Jev Pac-Man live demo" loading="lazy" sandbox="allow-scripts allow-same-origin allow-forms allow-popups" style={{ width: "100%", height: "500px", border: "1px solid var(--gray-a6, #33333340)", borderRadius: "8px" }} />
  </Tab>
</Tabs>

<sub>Live third-party demos. Not affiliated with this SDK.</sub>

## Personal-favorite Jev use cases

None of the four projects below are written in Go, and none use this SDK. They're added only because they're fun, rounded up by [Moritz Kremb](https://x.com/moritzkremb) in [this thread](https://x.com/moritzkremb/status/2100895894287839255). Full credit to each builder; these are their projects, unrelated to typesafe-sdk-go beyond calling the same API.

### Keystroke oracle launcher

[dabit3/launcher](https://github.com/dabit3/launcher) by [Nader Dabit](https://github.com/dabit3) — a native macOS launcher that judges intent on every keystroke. Type "the pdf I just downloaded" and Jev ranks the newest PDF top, at full confidence, in about 100 ms.

<Frame>
  <img src="https://mintcdn.com/typesafe-sdk-go/k_3Uxw_w1O3CfgEJ/images/jev-launcher-query-pdf.png?fit=max&auto=format&n=k_3Uxw_w1O3CfgEJ&q=85&s=57294bfc746cebe1316bb1cc61f701c3" alt="dabit3/launcher: typing 'the pdf I just downloaded' ranks the newest PDF top at 100% confidence in 154 ms" width="680" height="520" data-path="images/jev-launcher-query-pdf.png" />
</Frame>

<sub>Not related to this Go SDK, just a personal-favorite Jev use case.</sub>

### Context compaction

[tamaratran/fast-jev-compaction](https://github.com/tamaratran/fast-jev-compaction) by [tamara tran](https://github.com/tamaratran) — a Claude Code plugin that replaces lossy LLM-summarized compaction with Jev decisions: every tool call and result is scored, stale ones are dropped, everything kept stays verbatim.

<sub>Not related to this Go SDK, just a personal-favorite Jev use case.</sub>

### Ultrafast browser agent

[browser-use/jev-ultrafast](https://github.com/browser-use/jev-ultrafast) by [Browser Use](https://github.com/browser-use) — Jev picks the operation and element for each browser action instead of a full LLM generation pass. Zürich → London on Google Flights in 7.1 seconds, one natural-language goal.

![Browser Use jev-ultrafast: a real Google Flights search completing in 7.1 seconds](https://raw.githubusercontent.com/browser-use/jev-ultrafast/main/docs/demo.gif)

<sub>Not related to this Go SDK, just a personal-favorite Jev use case.</sub>

### Plain-English Postgres

[realZachi/pg-jev](https://github.com/realZachi/pg-jev) by [Zachi](https://github.com/realZachi) — ask a Postgres table questions in plain language; Jev turns the question into a query. See it live at [pgjev.zachi.dev](https://pgjev.zachi.dev) (not embeddable here, the site blocks iframes).

<sub>Not related to this Go SDK, just a personal-favorite Jev use case.</sub>

<Card title="View source on GitHub" icon="github" href="https://github.com/atharvamhaske/typesafe-sdk-go/tree/main/examples">
  Full source for every example.
</Card>