Skip to main content
Delegate coding tasks to the Blackbox AI multi-model CLI.

Skill metadata

Reference: full SKILL.md

The following is the complete skill definition that Mibyan loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.

Blackbox CLI

Delegate coding tasks to Blackbox AI via the Mibyan terminal. Blackbox is a multi-model coding agent CLI that dispatches tasks to multiple LLMs (Claude, Codex, Gemini, Blackbox Pro) and uses a judge to select the best implementation. The CLI (npm @blackbox_ai/blackbox-cli, binary blackbox) is a TypeScript coding agent (forked from Gemini CLI) and supports interactive sessions, non-interactive one-shots, checkpointing, MCP, and vision model switching.

Prerequisites

  • Node.js 20+ installed
  • Blackbox CLI installed: npm install -g @blackbox_ai/blackbox-cli (binary: blackbox)
  • API key from app.blackbox.ai/dashboard
  • Configured: run blackbox configure and enter your API key
  • Use pty=true in terminal calls — Blackbox CLI is an interactive terminal app

One-Shot Tasks

For quick scratch work:

Background Mode (Long Tasks)

For tasks that take minutes, use background mode so you can monitor progress:

Checkpoints & Resume

Blackbox CLI has built-in checkpoint support for pausing and resuming tasks:

Session Commands

During an interactive session, use these commands:

PR Reviews

Clone to a temp directory to avoid modifying the working tree:

Parallel Work

Spawn multiple Blackbox instances for independent tasks:

Multi-Model Mode

Blackbox’s unique feature is running the same task through multiple models and judging the results. Configure which models to use via blackbox configure — select multiple providers to enable the Chairman/judge workflow where the CLI evaluates outputs from different models and picks the best one.

Key Flags

Vision Support

Blackbox automatically detects images in input and can switch to multimodal analysis. VLM modes:
  • "once" — Switch model for current query only
  • "session" — Switch for entire session
  • "persist" — Stay on current model (no switch)

Token Limits

Control token usage via .blackboxcli/settings.json:

Rules

  1. Always use pty=true — Blackbox CLI is an interactive terminal app and will hang without a PTY
  2. Use workdir — keep the agent focused on the right directory
  3. Background for long tasks — use background=true and monitor with process tool
  4. Don’t interfere — monitor with poll/log, don’t kill sessions because they’re slow
  5. Report results — after completion, check what changed and summarize for the user
  6. Credits cost money — Blackbox uses a credit-based system; multi-model mode consumes credits faster
  7. Check prerequisites — verify blackbox CLI is installed before attempting delegation