Roadmap
CruxCLI is an open-source terminal AI coding agent with 24 task-specific modes, token budgets, workspace checkpoints, and a convergence engine. This roadmap shows what we have shipped, what we are building now, and what comes next. Updated March 2026.
Completed
Hard fork from OpenCode
Phases 1-6: fork, rebrand, prompt replacement, bridge absorption, token budgets, build verification. CruxCLI binary compiles and runs independently.
Workspace checkpoints
Automatic git-based snapshots before destructive tool operations. Up to 50 checkpoints per project with restore support.
VS Code extension
Native VS Code extension with keybindings, inline diff, and marketplace distribution. In sdks/vscode/.
Competitive analysis
5-pass research on OpenCode, Claude Code, Gemini CLI, Codex CLI. Feature matrix, moat inventory, gap closure queue documented.
Key migration documentation
BUILD_PLAN_005 written covering API key migration from environment variables to OS keychain.
In progress
API key migration
Moving from environment variable-based API key management to a secure credential store. Target: cruxcli auth command using OS keychain (macOS Keychain, Linux libsecret, Windows Credential Manager).
CruxDev integration hardening
Structured error reporting, convergence state persistence across restarts, and progress visualization in the TUI. The MCP connection works; reliability and UX need polish.
Plugin ecosystem
Formalizing the plugin API. The @cruxcli/plugin package exists but needs documentation, registry support, and a cruxcli plugin add command.
Planned
Browser automation mode
A Crux mode that knows to suggest Playwright MCP tools for frontend testing and doc scraping. Integration, not reimplementation.
Enterprise compliance tier
Audit trail export, SSO/SAML, role-based mode restrictions, approved-model-only policies. Building blocks exist in the 5-gate safety pipeline. Won't build until enterprise demand exists.
Memory pipeline
Correction detection feeding into a knowledge base that improves mode prompts over time. The agent gets better at your codebase the longer you use it.
Cost visibility
Real-time dollar cost display per session and per mode. Token budgets track tokens; this adds price-per-token mapping.
Image/screenshot input
Accept images as context for UI-related tasks. Closing a gap vs Codex CLI.
Non-goals
These are intentional exclusions, not missing features. We will not build these.
Upstream sync with OpenCode
Clean break. We monitor upstream for good ideas and integrate selectively. No rebase relationship, ever.
Building what can be integrated
Browser automation, linting, formatting — these have MCP servers. CruxCLI's mode system points agents at the right tools. We don't rebuild what exists.
Node.js runtime support
CruxCLI is Bun-only. This is intentional for faster compilation and smaller binaries.
Free hosted service
CruxCLI is a local tool. Users bring their own API keys. We are not building a hosted SaaS.
Help build CruxCLI
CruxCLI is open source (MIT). Contributions, feedback, and bug reports welcome.