The provider-agnostic AI coding agent with intelligence built in
CruxCLI is a terminal AI coding agent that works with any LLM provider. 24 task-specific modes map to model tiers automatically, token budgets replace step-count limits, and workspace checkpoints protect your code. Open source, self-hostable, 1,204 tests passing.
1,204
Tests passing
13/13
Packages typecheck
75+
LLM providers
24
Task-specific modes
AI coding agents are powerful. But they lack intelligence.
Most terminal agents send your prompt to one model with one personality. CruxCLI matches the right model to the right task, automatically.
Without CruxCLI
- × One model for everything — Opus for a typo fix, same as for architecture
- × Step-count limits — agent stops after N tool calls regardless of progress
- × No safety net — destructive edits with no automatic rollback
- × Locked to one provider — switch vendors, rewrite your workflow
- × No convergence signal — you guess when the code is “done”
With CruxCLI
- ✓ Mode→model tier mapping — routine tasks use cheap models, complex ones get strong models
- ✓ Token budgets — per-mode limits with 75% warning and 90% hard stop
- ✓ Workspace checkpoints — auto-snapshot before every destructive operation
- ✓ 75+ providers — Anthropic, OpenAI, Google, OpenRouter, Ollama, and more
- ✓ CruxDev convergence — autonomous audit-fix loops to verified completion
What makes CruxCLI different
Six capabilities no other terminal AI agent has. Not one. We checked.
Mode → Model Tier Mapping
24 task-specific modes automatically select the right model tier. Debugging gets a stronger model than formatting. You save money without thinking about it.
Token Budget System
Per-mode token budgets replace crude step-count limits. Warning at 75%, hard stop at 90%. Finer cost control than counting tool calls.
CruxDev Convergence Engine
Autonomous audit-fix-re-audit loops that run until two consecutive clean passes. The agent doesn't stop when it thinks it's done — it stops when it proves it's done.
Workspace Checkpoints
Automatic git-based snapshots before every destructive tool call. Up to 50 checkpoints per project. Restore to any point with one command.
Client/Server + LSP
HTTP server on port 4096 drives TUI, web, desktop, and VS Code surfaces. Built-in LSP client supports 30+ language servers for real code intelligence.
Crux Intelligence Layer
24 research-optimized mode prompts, correction detection, and continuous learning — native in the binary, not a plugin. The agent gets smarter as you use it.
Get started in 4 steps
Install
npm i -g cruxcli Configure
export ANTHROPIC_API_KEY=sk-... Launch
cruxcli Build
> refactor auth module Works with the providers you already use
Start building with CruxCLI
Open source. Provider-agnostic. Intelligence built in. One command to install.