Skip to content
Elenchos
Install
QuickstartVerificationKaneMCPAgentsEvidenceSecurity

Install and run.

Start with a global CLI install. Kane login is only required when you want a real browser pass.

Terminal
npm install -g elenchos

Requirements

  • Node.js 20 or newer
  • Git
  • A coding-agent CLI for a full run: agy, claude, gemini, or codex
  • Kane CLI, authenticated, when you want browser verification

Confirm the binary

Terminal
elenchos --help

Use npx elenchos if the global binary is not on PATH. Windows, macOS, and Linux are supported.

Doctor

Doctor reports MCP handshake status, project configuration, Kane install, authentication, credits, and the selected task or test. It does not start a run.

Terminal
npx elenchos doctor --repo . demo/tasks/add-task.json

Add --json for machine output. Add --strict when a script should fail unless Kane verification is ready.

1. init

Inspects the repository and writes .elenchos/config.json. Ambiguous start commands, URLs, or agents stay unresolved until you pass them.

npx elenchos init

2. author

Sends the task to Kane generate --agent, then saves exactly one Functional _test.md file. Elenchos will not invent a test during a run.

npx elenchos author demo/tasks/add-task.json --output demo/tests/add-task_test.md

3. run

Creates a detached worktree, sends the task to the agent, starts the app, and asks Kane to check the locked contract.

npx elenchos run demo/tasks/add-task.json

Init with explicit choices

When init finds more than one start command, URL, or agent, pass the choice yourself and rerun with --force.

Terminal
npx elenchos init --force --start "npm run dev" --url http://127.0.0.1:5173 --agent agy

Kane, only for real verification

Terminal
npm install -g @testmuai/kane-cli
kane-cli login
kane-cli whoami
kane-cli balance

Verify without an agent

Use verify when the code is already implemented and you want Kane to check the current worktree. This mode does not isolate a worktree or enter repair.

Terminal
npx elenchos verify demo/tasks/add-task.json

Inspect a run

Terminal
npx elenchos status <run-id>

The CLI exits successfully only when run or verify ends in VERIFIED.