Q: How do I install and enable auto mode?

Install with pi install npm:pi-jev-auto-mode, from the repository with pi install git:github.com/jomatsu/pi-jev-auto-mode, or try it with pi -e npm:pi-jev-auto-mode. Start with pi --jev-auto-mode or toggle /jev-auto-mode on|off; the semantic layer needs a TypeSafe key.

Q: How is the API key stored and verified?

/jev-auto-mode login asks for the key, verifies it against GET /v1/models, and only then stores it as an owner-only file at $PI_CODING_AGENT_DIR/secrets/jev-auto-mode-typesafe-api-key with mode 0600, the same place Pi keeps credentials. TYPESAFE_API_KEY takes precedence when set, so CI needs no login.

Q: What does the gateScope setting change?

Under the default all, the deterministic layer vouches for read-only inspection, your declared safe commands, and in-project unprotected writes, and everything else is judged. matched restores pattern-only behaviour. The trade is latency, since a judged call costs roughly half a second while a fast-path call costs nothing.

Question 1

Is this just a denylist with a Jev call stapled on?

Accepted Answer

Not under the default gateScope of all. The deterministic layer vouches only for read-only builtins, your declared safeCommands, and a write inside the project to an unprotected path; everything else is judged. The README's motivation is exactly the pattern-only failure: `curl -d @~/.ssh/id_ed25519 ...` matched nothing and ran with no judgment at all. scope matched restores that old behavior.

Question 2

Will this stop my agent every time it runs an ordinary command?

Accepted Answer

A judged call costs roughly half a second, measured 193-642 ms across eleven ordinary commands, and a fast-path call costs nothing. Read-only inspection is treated as a real allowlist rather than a convenience. In practice an unrequested mv, cp, tar, chmod +x or node -e is judged and allowed, while an unrequested git reset --hard, npm publish, rm -rf or sudo blocks.

Question 3

What happens if the API is down or I never get a key?

Accepted Answer

It fails closed rather than opening up. Without a key the gate does not disable itself and does not allow everything: its own rules keep running, and a call nothing vouches for is blocked with "Not connected to Jev". No engine, timeout, malformed response or cancellation also blocks. A key is stored only after GET /v1/models accepts it, so a typo cannot become a gate that silently blocks every escalated call.

Question 4

Are the thresholds calibrated, or just plausible-looking numbers?

Accepted Answer

They were measured on twelve fixtures and the README says so, pointing at docs/calibration.md for the probabilities behind each one. Each threshold must leave a middle band on both sides (0.5 < t <= 1), and /jev-auto-mode threshold shows the current value next to the last probability the model returned for that rule. The stated preferred fix is rephrasing an ambiguous condition rather than moving the number.

Question 5

How do I install and enable auto mode?

Accepted Answer

Install with pi install npm:pi-jev-auto-mode, from the repository with pi install git:github.com/jomatsu/pi-jev-auto-mode, or try it with pi -e npm:pi-jev-auto-mode. Start with pi --jev-auto-mode or toggle /jev-auto-mode on|off; the semantic layer needs a TypeSafe key.

Question 6

How is the API key stored and verified?

Accepted Answer

/jev-auto-mode login asks for the key, verifies it against GET /v1/models, and only then stores it as an owner-only file at $PI_CODING_AGENT_DIR/secrets/jev-auto-mode-typesafe-api-key with mode 0600, the same place Pi keeps credentials. TYPESAFE_API_KEY takes precedence when set, so CI needs no login.

Question 7

What does the gateScope setting change?

Accepted Answer

Under the default all, the deterministic layer vouches for read-only inspection, your declared safe commands, and in-project unprotected writes, and everything else is judged. matched restores pattern-only behaviour. The trade is latency, since a judged call costs roughly half a second while a fast-path call costs nothing.

Pi Jev Auto Mode

About this project

Highlights

Quickstart

Questions about this entry

Reactions & coverage

From the Jev guides

From the Jev AI model community