Built for the way you work.
Plan mode divides complex tasks into ordered steps that you can approve, comment on, or rewrite before any change applies.
AGENTS.md, plugins, hooks, skills, and MCP servers all work with no configuration: the CLI reads your conventions immediately.
Run /multi-agent to send the same task to Blackbox, Claude Code, Codex, and Gemini in parallel, each on its own worktree.
What you get.
Plan mode finds mistakes before you apply them
Start the CLI in plan mode for complex tasks. Approve the plan, comment on individual steps, or rewrite it before execution starts. After approval, each change shows as a clean diff for review.
Plan mode starts a planning agent that divides the work into ordered steps. Edit steps inline, reject an individual edit, or require manual approval for each file before changes apply.
MCP, plugins, hooks, AGENTS.md: no configuration needed
Your AGENTS.md, plugins, hooks, skills, and MCP servers all work with no configuration. Put the CLI in your repository, and it reads your conventions, scripts, and toolchain immediately.
Browse plugins from /plugins. MCP servers connect via `~/.blackbox/mcp.json`. Skills load from `.blackbox/skills/`. Hooks run on PreToolUse, PostToolUse, and Stop events.
Run four agents in parallel. Select the best result.
Run /multi-agent to send the same task to Blackbox, Claude Code, Codex, and Gemini at the same time. Chairman LLM evaluates each implementation and selects the best result.
Each agent runs on its own Git worktree, so changes do not conflict. Monitor the streaming output as the agents work. Override the selection from Chairman LLM, or merge implementations.
Headless mode for CI/CD pipelines
Headless mode (-p) runs agents inside scripts, CI pipelines, and automations without an interactive prompt. ACP support lets you build bots and agent-orchestration applications on the CLI.
Pipe output, chain with standard Unix tools, and set per-command timeouts and exit codes. It works in `Docker`, GitHub Actions, GitLab CI, and any environment with `Node 20+`.
Common questions.
HOW DO I INSTALL THE CLI?
Run npm install -g @blackbox/cli on macOS, Linux, or Windows. Alternatively, use curl -fsSL https://blackbox.ai/install.sh | bash on Unix systems, or the PowerShell installer on Windows.
DOES IT WORK WITH ANY LANGUAGE?
Yes. The CLI supports all major languages and frameworks, which include React, Vue, Angular, Node.js, Python, Java, and Go. It automatically detects the language, framework, and conventions of your project.
CAN I USE IT IN CI/CD PIPELINES?
Yes. The CLI supports non-interactive mode for automated workflows, which include code generation, test generation, security scans, and deployment automation. It integrates with Docker, AWS, GCP, and standard CI/CD tools.
IS MY CODE SENT TO THE CLOUD?
We send code context with end-to-end encryption and AES-256 encryption at rest. Enterprise adds a single-tenant deployment on capacity reserved for you, isolated from every other customer.
IS THE CLI OPEN SOURCE?
Yes. Blackbox CLI is fully open source, with the code available on GitHub. You can contribute, report issues, or audit the code directly.
WHAT AGENTS ARE AVAILABLE IN MULTI-AGENT MODE?
Multi-agent mode supports Blackbox, Claude Code, Codex, Gemini, Goose, OpenCode, and Qwen agents. Each agent works on a separate Git branch, and Chairman LLM evaluates all implementations and selects the best result.
DOES THE CLI SUPPORT WEB SEARCH?
Yes. The CLI includes web search that starts automatically when a task needs real-time information, with access to X (Twitter) for social insights. Responses include source citations.