blackbox

Delegate coding tasks to the Blackbox AI multi-model CLI agent.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill blackbox-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blackbox
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/optional-skills/autonomous-ai-agents/blackbox
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill blackbox-kaminocorp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @blackboxai/cli.

What problem does it solve? Delegating coding work to an external AI agent requires managing interactive terminal sessions, long-running tasks, and multi-model evaluation, which is difficult to orchestrate manually from a chat interface. ## Core Features & Use Cases - One-Shot Task Delegation: Run non-interactive coding tasks with blackbox --prompt against any project directory. - Background Execution & Monitoring: Launch long tasks in background mode and track progress with poll, log, and submit process actions. - Multi-Model Judge Mode: Dispatch the same task to multiple LLMs (Claude, Codex, Gemini, Blackbox Pro) and let the built-in judge select the best implementation. - Use Case: You need JWT authentication added to an Express API. Delegate the task to Blackbox in background mode, monitor its progress, and review the resulting changes without leaving your conversation. ## Quick Start Ask the agent to run Blackbox on your project, for example: use Blackbox to add JWT authentication with refresh tokens to the Express API in my project directory.

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 with the --prompt flag followed by your task description, for example blackbox --prompt 'Add JWT authentication to the Express API'. Set the workdir to your project directory and always use pty=true since the CLI is an interactive terminal application.

How do I run long Blackbox tasks in the background?▼

Start the CLI with background=true and pty=true to receive a session ID, then monitor progress with process poll and log actions. You can send input with the submit action if Blackbox asks a question, or kill the session if needed.

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

Multi-model mode runs the same task through several LLMs such as Claude, Codex, Gemini, and Blackbox Pro, then a built-in judge evaluates the outputs and selects the best implementation. Configure multiple providers via blackbox configure to enable this workflow.

Can Blackbox resume a previous coding session?▼

Yes, Blackbox has built-in checkpoint support. After a task completes it shows a checkpoint tag, and you can resume with blackbox --resume-checkpoint followed by the tag and a new prompt for follow-up work.

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

Blackbox CLI is an interactive terminal application that expects a pseudo-terminal for rendering and input handling. Always pass pty=true in terminal calls, otherwise the process will hang waiting for terminal interaction.

What are the prerequisites for using the Blackbox CLI?▼

You need Node.js 20 or later, the CLI installed via npm install -g @blackboxai/cli or from source, and an API key from app.blackbox.ai configured with blackbox configure. Note that usage consumes credits, and multi-model mode consumes them faster.