Skip to main content
plugin CX Codex

jev-use — Claude Code plugin: what it does, how to install

jev-use offloads non-text decisions and shell execution checks to the Jev judgment model to cut token usage.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install jev-use@awesome-codex-plugins
Open on GitHub

What jev-use does

The plugin routes lightweight decision steps away from the core LLM to TypeSafe's Jev model. Tasks such as picking an action from an enum, evaluating a test run status, or screening terminal commands run in single batched calls with typed outcomes. When Jev hits uncertainty, it hands execution back to the reasoning model with an explicit escalation flag.

Inside, the package provides an MCP server, a PreToolUse shell gate, and a redactor that strips credentials before sending gated actions. Diagnosis is handled via npx -y jev-use doctor.

Live execution demands an API key from TypeSafe (TYPESAFE_API_KEY), OpenRouter (OPENROUTER_API_KEY), or Vercel AI Gateway (AI_GATEWAY_API_KEY). Setting JEV_BACKEND=mock keeps judgment local for dry runs without credentials.

What it helps with

  • screen dangerous shell commands before execution begins
  • reduce LLM token spend on yes-or-no workflow checks
  • compact oversized context transcripts through relevance filtering
  • pick UI controls or immediate next steps without text generation

Example prompts for the agent

  • Gate the following shell commands using jev-use before running them
  • Compact this conversation transcript with Jev and summarize dropped entries
  • Check whether the build succeeded and pick the next deployment step

How to install jev-use

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install jev-use@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about jev-use

How to install jev-use in Claude Code?

Run both commands in order: /plugin marketplace add hashgraph-online/awesome-codex-plugins followed by /plugin install jev-use@awesome-codex-plugins.

What does jev-use do?

It assigns non-text decisions, context compaction triage, and shell security checks to the fast Jev model rather than spending LLM tokens.

Which environment variables are required?

Set either TYPESAFE_API_KEY, OPENROUTER_API_KEY, or AI_GATEWAY_API_KEY. Alternatively, specify JEV_BACKEND=mock for testing without API keys.

Source text

jev-use · MIT
# jev-use

**English** | [简体中文](README.zh-CN.md)

The best way for Claude Code, Codex, and [pi](https://github.com/badlogic/pi-mono)
to work with [Jev](https://typesafe.ai/blog/introducing-system-one-models-and-jev):
hand the tasks that need no text output to Jev — faster steps, fewer
tokens, tasks done sooner and better.

It makes the LLM and Jev true collaborators: when content needs to be
written, the LLM takes over; when a step just needs a fast decision, Jev
executes it.

## Demos — real runs, 1× speed

<table>
<tr>
<td width="50%" valign="top"><b>Directions task: Jev clicks, the LLM types</b> — 10 decisions (p50 274 ms) · 4 writes; Jev rejects a wrong route, the LLM rewrites<br><img src="assets/collab.gif" alt="OpenStreetMap directions: Jev picks controls in green, the LLM types the locations in blue; a wrong 1809km geocode is rejected by Jev and repaired by the LLM, ending on the real 3.7km walking route" width="100%"></td>
<td width="50%" valign="top"><b>Context compaction</b> — 200 messages judged in 7 calls, one LLM paragraph replaces the dropped pile; recall 3/3<br><img src="assets/compact.gif" alt="A real transcript fills the context window to 94%; Jev tints each message keep or drop, the LLM's summary paragraph replaces the dropped block, the window falls to 44% and three recall checks pass" width="100%"></td>
</tr>
<tr>
<td width="50%" valign="top"><b>Pong: ball speed = decision latency</b> — 86 Jev decisions in 20 s vs 6 (haiku) and 3 (gemini) called the usual way; enum-constrain both and the gap is 3×<br><img src="assets/pong.gif" alt="Three Pong lanes replaying a live run at 1x: the Jev ball sweeps the field at ~224ms per decision while the LLM balls crawl" width="100%"></td>
<td width="50%" valign="top"><b>Gate every shell command</b> — dangerous ones denied in ~230 ms with a reason, zero LLM tokens<br><img src="assets/gate.gif" alt="A 24-command dev session gated at 1x: dangerous commands denied at confidence 1.00, benign ones allowed" width="100%"></td>
</tr>
</table>

Every demo is a rerunnable script in [bench/examples/](bench/examples);
all numbers, methodology, variance and caveats:
[bench/RESULTS.md](bench/RESULTS.md) · third-party measurements:
[docs/evidence.md](docs/evidence.md).

## Install

```bash
npx -y jev-use install    # wires Claude Code, Codex, and pi — whichever it finds
```

Set one key in the environment your agent runs in (`JEV_BACKEND=mock` for
a keyless dry run):

| Provider | Env var |
| --- | --- |
| [TypeSafe direct](https://typesafe.ai/) | `TYPESAFE_API_KEY` |
| [OpenRouter](https://openrouter.ai/typesafe/jev-1.13) | `OPENROUTER_API_KEY` |
| [Vercel AI Gateway](https://vercel.com/ai-gateway/models/jev) | `AI_GATEWAY_API_KEY` |

`npx -y jev-use doctor` checks the wiring. Judged state goes to the
provider you configure; `JEV_BACKEND=mock` stays local. Plugin form with
the routing skill and the PreToolUse gate:
[harness/claude-code](harness/claude-code/README.md) ·
[harness/codex](harness/codex/README.md).

## Use as a library

`npm i jev-use` — zero runtime dependencies on the judgment path:

```js
import { Jev, check, pick, rate } from "jev-use";

const jev = new Jev();

const { answers } = await jev.judge(state, {
  next: pick("Next action?", { merge: "all green", rerun: "looks flaky", hold: "needs attention" }),
  risk: rate("How risky?", ["routine", "worth a look", "incident"]),
  passed: check("Did the run fully succeed?"),
});
// answers.next → { answer: "merge", confidence: 0.93, confidenceFrom: "reported", escalate: false }
```

Anything Jev can't or shouldn't decide comes back with `escalate: true`
and a typed reason. Tools, verdict shape, escalation contract, CLI:
[docs/reference.md](docs/reference.md).

## Small enough to read

| File | Job |
| --- | --- |
| [src/protocol.ts](src/protocol.ts) | Questions (`check`/`pick`/`rate`), verdicts, escalation reasons |
| [src/dispatch.ts](src/dispatch.ts) | Pre-call routing: what never reaches Jev |
| [src/judge.ts](src/judge.ts) | screen → backend → hand back what is unsure; `gate` |
| [src/jev.ts](src/jev.ts) | The `Jev` client over that engine |
| [src/redact.ts](src/redact.ts) | Credentials stripped from a gated action before it is sent |
| [src/backends/](src/backends) | TypeSafe, OpenRouter, Vercel, mock adapters |
| [src/server.ts](src/server.ts) | The two MCP tools |
| [src/cli.ts](src/cli.ts) | `install`, `serve`, `hook gate`, `doctor` |
| [skills/jev-use/SKILL.md](skills/jev-use/SKILL.md) | The routing rules the agent follows |

## Development

```console
$ npm run typecheck && npm test    # unit tests incl. per-provider wire fixtures
$ npm run smoke                    # real MCP client ↔ built CLI over stdio
$ node bench/run.mjs               # micro-benchmarks, your key and region
```

Substantially written with Claude Code (AI-assisted).

MIT © [shitianfang](https://github.com/shitianfang)

© shitianfang · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
maestro maestro sends a prompt to several local model CLIs, then has a judge compare their answers and a synthesizer produce a grounded result. Use it when you want one considered response from a model panel. CX Codex ★ 1,596repo stars lvtd-skills lvtd-skills is a plugin for Claude Code and Codex with ready-made agent skills for Django, htmx, Rust, developer docs, SEO, traction and nonfiction books, one SKILL.md per topic. CX Codex ★ 1,596repo stars krypton krypton is a Claude Code and Codex plugin that turns development requests into plans with owners, cutover decisions, and acceptance evidence. Use it for feature work, bug fixes, refactors, migrations, and architecture goals. CX Codex ★ 1,596repo stars kernel kernel is a plugin for Claude Code and Codex that uses hooks to block destructive commands and gate irreversible steps with a one-time token. CX Codex ★ 1,596repo stars sirv-media-skills sirv-media-skills is a Claude Code and Codex plugin with eight skills for auditing images and video, Sirv APIs, galleries, 360 spins, and media performance. CX Codex ★ 1,596repo stars hotl hotl pushes implementation work through eight stages, from a design doc to test evidence. Built for features, refactors and changes you would rather not improvise. CX Codex ★ 1,596repo stars codex-honcho codex-honcho provides persistent cross-session memory through the Honcho API, keeping context and user preferences across restarts. CX Codex ★ 1,596repo stars homie homie helps create multiplayer games, music, and video, then publish them from a studio running on your own Cloudflare account. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open