pi-jev-eye
Lean Pi supervisor: zero-token regex guardrails, done-check verification, per-turn routing and a Jev/Clef semantic slop gate on diffs.
Overview
pi-jev-eye is a zero-dependency supervisor for the Pi coding agent with three layers. An instant regex gate blocks wipes such as rm -rf / or DROP DATABASE, protected-branch force-pushes and hardcoded secrets at zero latency and token cost. A done-check warns when the agent claims completion after editing files without running verification suites. A targeted semantic gate evaluates diffs of 10 or more lines with a has_slop question to reject placeholder stubs and unfulfilled TODOs.
The semantic gate can use TypeSafe Jev, OpenRouter or Cloudflare Workers AI with Clef or clef-flash, chosen at login; the README notes Clef runs within Cloudflare's free daily allowance for most sessions. A usage panel compares Jev and Clef requests, tokens and cost. It also offers reviewed turns with Jev scoring tables, per-turn model routing between fast and heavy models, and fails open on network errors. It is MIT licensed.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Yes / no | has_slop: does this diff contain placeholder stubs or unfulfilled TODOs? | yes · no |
| Choice | Is this a light chore or complex task for model routing?(inferred) | light · heavy |
How it works
- Regex gate checks commands and writes instantly.
- For diffs of 10+ lines, ask the semantic slop question.
- Warn if the agent claims done without running tests.
- Route each turn to a fast or heavy model.
Strengths
- Zero-cost first layer.
- Choice of Jev, OpenRouter or free-tier Clef.
- Fails open to avoid stalling sessions.
Caveats
- Regex rules catch only known patterns.
- Fail-open means outages skip the semantic gate.
Getting started
pi install npm:@bismawy/pi-jev-eye, then /jev-eye login.At a glance
- Type
- Project
- Status
- beta
- Language
- TypeScript
- Runtime
- Pi extension
- Has code
- yes
- License
- MIT
Use cases and integrations
How curated lists describe it
Ultra-lean supervisor for Pi: zero-token regex guardrails, test verification tracking, and TypeSafe Jev semantic slop gate.
logicrw/awesome-jev-projectsUltra-lean supervisor for Pi: zero-token regex guardrails, test verification…
wh000wh000/awesome-jev-liveUltra-lean supervisor for Pi: zero-token regex guardrails, test verification tracking, and TypeSafe Jev semantic slop gate.
hellogumbo/awesome-jev
Frequently asked questions
What does the semantic gate check?
Whether larger diffs contain placeholder stubs or unfulfilled TODOs.
Can it run free?
Using Cloudflare's Clef, most sessions fit in the free daily allowance per the README.
Does it block dangerous commands?
Yes, via an instant regex gate.
Related projects
Pi guardrails on pi-typesafe that steer the agent: Jev checks rule breaks, irreversible actions, stuck loops and unverified done claims.
HookbetaTypeScriptCoding-agent hook that asks Jev one yes/no per project rule on every edit or turn and makes the agent fix any violation.
HookbetaTypeScriptSelf-hosted software factory running coding agents in microVMs with verification gates; offers optional DSPy/Jev task intake advice.
ServicebetaPythonPi extension that checks proposed code edits against repository Markdown rules with Jev, reporting rule text and line ranges.
ProjectbetaTypeScriptAuditable Zig terminal agent pairing Codex for coding with Jev typed preflight and postflight checks under deterministic policy gates.
CLIproductionZigClaude Code plugin that checks every reply and file edit against your CLAUDE.md rules with one Jev yes/no per rule.
PluginbetaTypeScript