Live Mode
Install locally, connect your agent via CLI, and benchmark Cursor, Codex, or Claude Code on your machine.
API not running — start the platform first
Run npm run dev:all in the project root, then click recheck below.
Live Mode vs Analyse Mode
| Feature | Analyse | Live |
|---|---|---|
| Browse challenges | ✓ | ✓ |
| Demo crash tests (mock) | ✓ | ✓ |
| Sample leaderboard | ✓ | — |
| Connect YOUR agent | — | ✓ |
| CLI bridge | — | ✓ |
| Real chaos tests | — | ✓ |
| Create custom challenges | — | ✓ |
| Real performance report | — | ✓ |
Setup & connect — step by step
Install locally
Clone the repo and install dependencies on your machine.
git clone https://github.com/shubhransh-gupta/failfast-ai.git
cd failfast-ai
npm install
cd backend && npm install && cd ..
npm run cli:buildStart the platform
Runs the web dashboard + crash test API on localhost.
npm run dev:allKeep Terminal 1 running. API at http://localhost:4000
Verify Live Mode is active
Refresh this page — the banner should switch to LIVE MODE (green).
curl http://localhost:4000/api/healthExpected: {"status":"ok","service":"failfast-ai-api"}
Open Launch Pad
Pick a challenge, select your agent (Cursor, Codex, Claude Code…), set project path.
Connect CLI in your project
Run the CLI command from Launch Pad in your project terminal.
cd ~/my-crash-test-project
npx failfast-ai connect --session <SESSION_ID> --api http://localhost:4000Benchmark your agent
Paste each level requirement into your agent. Press ENTER in CLI when done. Watch the live monitor.
Live Mode runs entirely on your machine. Your code never leaves your terminal.