spec.jevStart here
The command line
spec.jev's commands, the slash commands inside a session and what comes from pi unchanged.
The spec.jev command is pi, the coding agent, with spec.jev's judgment kernel loaded. Everything pi does works as before; spec.jev adds its own commands and the decision points.
npm i -g spec.jev # needs Node.js 22.19 or newer
spec.jev # an interactive session in the current directory
Starting spec.jev
| Command | What it does |
|---|---|
spec.jev |
An interactive session in the current directory |
spec.jev "prompt" |
Interactive, starting with this prompt |
spec.jev -p "prompt" |
One shot: print the answer and exit |
spec.jev -c |
Continue the last session |
spec.jev -r |
Pick a session to resume |
spec.jev --help |
Every flag of the agent |
spec.jev install, remove, update, list and config manage pi packages, as in pi.
spec.jev's own commands
| Command | What it does |
|---|---|
spec.jev setup |
Connect a model (an API key, or a service from a list) and choose the judge. spec.jev setup --help shows the forms for scripts. |
spec.jev doctor |
Check the installation, the model, the judges and the connections, and say what to fix |
spec.jev ledger [n] [--json] |
What the judge decided in the last n sessions. --json gives every record with its probabilities and timings. |
spec.jev import --list |
Find your Claude Code and Codex conversations |
spec.jev import <file>… |
Bring them into spec.jev, to continue there |
spec.jev judge setup | start | stop | status |
The local judge, Laya. setup asks before downloading the model. |
spec.jev link / spec.jev unlink |
Put the spec.jev command on your PATH (~/.local/bin), or remove it |
spec.jev auth status | login <provider> | logout <provider> |
Subscription sign-in, as used by the desktop app |
spec.jev migrate [--dry-run] |
One-time: move the old ~/.spec.jev folder to ~/.spec.jev |
Commands inside a session
| Command | What it does |
|---|---|
/status |
The judge, each decision point's mode, what was left out of the context, the latest verdicts |
/mu judge <judges> |
Which judges answer, in order: laya, laya,jev, jev-opencode-free, classifier:<provider>/<model>, llm:<provider>/<model> |
/mu route <point> <judges> |
Give one decision point its own judges |
/mu mode <point> <off|shadow|active> |
Switch one decision point, or default for all, for this session |
/frame |
The task frame: the goal, your constraints and where you said them, the acceptance items |
/goal <condition> |
Keep working until the condition holds; /goal clear ends it |
/permissions |
Full access, Jev approves or Ask first |
/board |
Switch the plain-language board on or off for this project; /board model picks its model |
/remember <text>, /lessons, /forget <id> |
Keep a lesson, list the lessons, retire one |
/review, /commit |
Review the changes, findings sorted P0 to P3; split the changes into commits |
/checkpoints, /rewind |
List the checkpoints; go back to one (/rewind undo undoes it) |
/agents, /swarm |
List subagent roles; see what each subagent is doing |
/hive <question> |
Start a hive on a hard question |
/browse, /jobs |
The built-in browser; background commands |
/capabilities, /ledger |
Which capabilities are installed and which are open; the latest verdicts |
/inherit |
What was taken over from Claude Code, Cursor and Codex, and what wasn't |
/import-chat |
Import a Claude Code or Codex conversation |
/doctor |
Check the configuration and the connections |
pi's own commands stay as they are: /model, /thinking, /login, /resume, /tree, /fork, /compact, /export, /mcp and the rest.
The verdict line
Before a turn starts, spec.jev waits briefly for the judge's reading of your message and shows it above the editor, for example ◆ jev-1.13-free multi-step task · full effort · 699 ms. Press Esc to start without waiting. The status line shows the permission mode and, while one runs, the goal.
Environment variables for one run
| Variable | Effect |
|---|---|
SPECJEV_JUDGE=laya,jev spec.jev |
Judges for this run only. SPECJEV_JUDGE=off turns the kernel off. |
SPECJEV_JUDGE_MODE=shadow spec.jev |
Every decision point in shadow for this run |
MU_PERMISSIONS=ask spec.jev |
The permission mode for this run: full, jev or ask |
SPECJEV_LANG=zh-CN spec.jev |
spec.jev's own messages in Chinese (zh) or English (anything else) |
The full list is under Configuration.