blackbox

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

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill blackbox-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blackbox
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/optional-skills/autonomous-ai-agents/blackbox
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill blackbox-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @blackboxai/cli.

What problem does it solve? Delegating coding tasks to an external AI coding agent requires managing interactive terminal sessions, long-running background processes, and multi-model configuration, which is error-prone when done manually. ## Core Features & Use Cases - One-Shot Task Delegation: Run non-interactive coding tasks through the Blackbox CLI with a single prompt in a target project directory. - Background Execution & Monitoring: Launch long-running tasks in background mode and monitor progress with poll, log, and submit process actions. - Checkpoints & Resume: Pause and resume tasks using Blackbox checkpoint tags for iterative multi-step development. - 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 result. - Use Case: Ask the agent to add JWT authentication to an Express API; it launches Blackbox in the project directory with a PTY, monitors the session, and summarizes the resulting code changes. ## Quick Start Use the blackbox skill to run the task "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 CLI?

Run blackbox with the --prompt flag followed by your task description, setting the workdir to your project directory and pty=true. For example: blackbox --prompt 'Add JWT authentication' executes the task non-interactively in one shot.

How do I run long Blackbox tasks in the background?

Start the CLI with background=true and pty=true, which returns a session ID. Monitor progress with process poll and log actions, send input with submit, and terminate with kill if needed.

What are the prerequisites for using the Blackbox CLI?

You need Node.js 20+, the CLI installed via npm install -g @blackboxai/cli, and an API key from app.blackbox.ai configured with blackbox configure. Terminal calls must use pty=true since it is an interactive app.

How does Blackbox multi-model mode work?

Blackbox dispatches the same task to multiple LLMs such as Claude, Codex, Gemini, and Blackbox Pro, then uses a built-in judge to evaluate outputs and select the best implementation. Configure multiple providers via blackbox configure to enable it.

Why does the Blackbox CLI hang when run from a terminal tool?

The CLI is an interactive terminal application and hangs without a pseudo-terminal. Always set pty=true in terminal calls so the session can render prompts and accept input correctly.

Can I resume a Blackbox task from a previous checkpoint?

Yes, Blackbox saves checkpoints after tasks complete and displays a checkpoint tag. Resume with blackbox --resume-checkpoint 'tag' --prompt 'follow-up task' to continue work in the same context.