blackbox

Delegate coding tasks to the Blackbox AI multi-model CLI via terminal sessions.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill blackbox-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blackbox
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/autonomous-ai-agents/blackbox
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill blackbox-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @blackbox_ai/blackbox-cli.

What problem does it solve? Offloading coding work to an external agent CLI requires managing interactive terminal sessions, checkpoints, and long-running background processes, which is error-prone to do manually. ## Core Features & Use Cases - Task Delegation: Run one-shot or interactive coding tasks through the Blackbox CLI, which dispatches work to multiple LLMs (Claude, Codex, Gemini, Blackbox Pro) and uses a judge to select the best implementation. - Background Execution & Monitoring: Launch long tasks in background PTY sessions and monitor them with poll, log, submit, and kill process actions. - Checkpoints & PR Reviews: Resume work from saved checkpoints and review pull requests in isolated temp clones without touching the working tree. - Use Case: Ask the agent to refactor an authentication module to OAuth 2.0; it starts Blackbox in a background PTY session in your project directory, monitors progress, and summarizes the resulting changes. ## Quick Start Use the blackbox skill to add JWT authentication with refresh tokens to the Express API in the current project.

Frequently Asked Questions about blackbox

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I delegate a coding task to Blackbox AI from the terminal?▼

Run blackbox --prompt "your task" in a PTY terminal session with the workdir set to your project. For long tasks, use background mode and monitor progress with the process poll and log actions.

What is Blackbox multi-model mode and how does it work?▼

Multi-model mode runs the same task through several providers such as Claude, Codex, Gemini, and Blackbox Pro, then a judge workflow evaluates the outputs and picks the best implementation. Select multiple providers via blackbox configure to enable it.

Why does the Blackbox CLI hang when run without a PTY?▼

Blackbox CLI is an interactive terminal application and requires a pseudo-terminal to function. Always set pty=true in terminal calls, otherwise the session will hang and produce no output.

Can I resume a Blackbox task from a previous checkpoint?▼

Yes, Blackbox CLI has built-in checkpointing. After a task completes it shows a checkpoint tag, and you resume with blackbox --resume-checkpoint "tag" --prompt "follow-up task" in the same project directory.

How do I review a pull request with Blackbox without modifying my working tree?▼

Clone the repository into a temporary directory, check out the PR with gh pr checkout, then run blackbox --prompt with review instructions inside that clone. This keeps your local working tree untouched.

What are the limitations and costs of using Blackbox CLI?▼

Blackbox uses a credit-based system, and multi-model mode consumes credits faster than single-model runs. It also requires Node.js 20+, a configured API key, and an installed CLI before any delegation can occur.