Skip to content

Stepwarden

A Claude Code plugin that verifies every tool call before it runs, asking Jev five parallel questions about the plan, scope, prior action and stated intent, then allowing, asking or blocking. Fresh installs ship in audit mode.

Stars
1
Language
TypeScript
License
APACHE-2.0
Published by
Community
Author
getexcited
Last verified
Oct 2026

About this project

A Claude Code plugin that verifies each agent action before it executes — not after the run finishes. It routes every tool call through a purpose-built verification model, TypeSafe AI's Jev, instead of a full LLM review, which is what makes checking every step affordable. That dialog is what mode: enforce looks like. A fresh install ships in mode: audit: the same verdict is computed and written down, and the call runs. You turn the gate on yourself, with /stepwarden enforce.

Quoted from the project's README. Read the full README.

Highlights

  • Five questions in parallel per call: plan contradiction, out-of-scope resource, contradiction with the last action, human check, intent consistency.
  • Three tiers, all inclusive of threshold: allow silently, ask with an Allow or Block dialog from 0.6, block outright at 0.9.
  • A full check takes about half a second and 740 to 1,200 input tokens, which is the argument for verifying every call.
  • Decisions are appended to .claude/stepwarden/<session>.jsonl, and every setting lives in the plugin configure dialog.

Watch out

The README labels this a proof of concept built on two early-access dependencies, Claude Code function hooks and Jev, states that its default thresholds have not been tuned on production traffic, and says plainly it is not a substitute for deterministic security controls. A fresh install runs in audit mode: every call is verified and logged but nothing is blocked or interrupted until you run /stepwarden enforce. When a human cannot be asked, which covers a headless -p run, a dismissed dialog, or more than 50 questions in a session, onNoAnswer decides and it defaults to allow. The middle tier is deliberate: blocking on a merely probable signal produces false stops exactly where a gate matters most, so block is reserved for near-certainty and the wide band in between asks you instead. Both thresholds are inclusive, bad configuration values fall back to defaults with a warning rather than taking the gate down, and thresholds that would make ask unreachable are repaired and reported. It needs Claude Code 2.1.273 or newer with function hooks enabled, and the plugin has no runtime dependencies and ships no lockfile, so installing it never runs npm. Keys go to the OS keychain through the configure command, and Claude Code does not read a .env file on its own. Copy reviewed against the repository README on 2026-10-04, not from running it.

Questions about this entry

Short answers drawn from the linked project or page.

More Jev resources like this

15GitHub stars
Node CLI that lints a file tree against fuzzy natural-language rules in one Markdown file, judging each matched file with a swappable TypeSafe-backed judge.
Jev Agents & MCP#community#jevbest#catalog-import
16GitHub stars
Single-command harness that turns a plain-language stack description into synced docs plus blocking hooks for Claude Code, Codex, and Pi, with deterministic presets or one Jev chooser call.
Jev Agents & MCP#community#jevbest#catalog-import
22GitHub stars
Runnable agent harness that moves pick, score and yes-no loop choices to Jev or Laya in milliseconds while reserving the language model for writing, compiling DECISION.md into executable questions.
Jev Agents & MCP#community#jevbest#catalog-import
35GitHub stars
Diff-aware test selector that sends the git diff to Jev with one question per test, then prints the native filter flags and hands them to vitest, jest, node, bun, Playwright, cargo, or go test.
Jev Agents & MCP#community#jevbest#catalog-import
22GitHub stars
Command-line toolkit that wraps Jev judgments into scriptable verify, screen, classify, extract, find, rerank, match, route, ask, compact, and batch commands.
Jev Agents & MCP#community#jevbest#catalog-import
24GitHub stars
Wires Jev into agents as seven MCP tools, an embeddable JevDecisionModel library with run functions, and Claude Code hooks at tool and turn boundaries.
Jev Agents & MCP#community#jevbest#catalog-import
Back to all resources

From the Jev community

Posts from builders shipping with Jev right now.

Follow @typesafeai