Blackbox CLI

Blackbox AI へのコーディングタスクを clawg ターミナル経由で委譲します。Blackbox は、複数の LLM（Claude、Codex、Gemini、Blackbox Pro）にタスクをディスパッチし、ジャッジを使って最適な実装を選択するマルチモデルコーディングエージェント CLI です。

この CLI は オープンソース（GPL-3.0、TypeScript、Gemini CLI からのフォーク）であり、インタラクティブセッション、非インタラクティブなワンショット実行、チェックポイント、MCP、ビジョンモデル切り替えに対応しています。

前提条件

• Node.js 20 以上がインストール済み
• Blackbox CLI がインストール済み: npm install -g @blackboxai/cli
• またはソースからインストール:

  git clone https://github.com/blackboxaicode/cli.git
  cd cli && npm install && npm install -g .
  

• app.blackbox.ai/dashboard から API キーを取得
• 設定済み: blackbox configure を実行し API キーを入力
• ターミナル呼び出しで pty=true を使用 — Blackbox CLI はインタラクティブターミナルアプリです

ワンショットタスク

terminal(command="blackbox --prompt 'Add JWT authentication with refresh tokens to the Express API'", workdir="/path/to/project", pty=true)

クイック作業の場合:

terminal(command="cd $(mktemp -d) && git init && blackbox --prompt 'Build a REST API for todos with SQLite'", pty=true)

バックグラウンドモード（長時間タスク）

数分かかるタスクの場合は、バックグラウンドモードを使用して進捗を監視できます:

# PTY を使用してバックグラウンドで開始
terminal(command="blackbox --prompt 'Refactor the auth module to use OAuth 2.0'", workdir="~/project", background=true, pty=true)
# session_id を返す

# 進捗を監視
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")

# Blackbox が質問をした場合は入力を送信
process(action="submit", session_id="<id>", data="yes")

# 必要に応じてキル
process(action="kill", session_id="<id>")

チェックポイントと再開

Blackbox CLI には、タスクを一時停止して再開するためのチェックポイントサポートが組み込まれています:

# タスク完了後、Blackbox はチェックポイントタグを表示
# フォローアップタスクで再開:
terminal(command="blackbox --resume-checkpoint 'task-abc123-2026-03-06' --prompt 'Now add rate limiting to the endpoints'", workdir="~/project", pty=true)

セッションコマンド

インタラクティブセッション中に、以下のコマンドを使用できます:

コマンド	効果
/compress	会話履歴を圧縮してトークンを節約
/clear	履歴をクリアして最初からスタート
/stats	現在のトークン使用量を表示
Ctrl+C	現在の操作をキャンセル

PR レビュー

作業ツリーの変更を避けるため、一時ディレクトリにクローン:

terminal(command="REVIEW=$(mktemp -d) && git clone https://github.com/user/repo.git $REVIEW && cd $REVIEW && gh pr checkout 42 && blackbox --prompt 'Review this PR against main. Check for bugs, security issues, and code quality.'", pty=true)

並列作業

独立したタスク用に複数の Blackbox インスタンスを起動:

terminal(command="blackbox --prompt 'Fix the login bug'", workdir="/tmp/issue-1", background=true, pty=true)
terminal(command="blackbox --prompt 'Add unit tests for auth'", workdir="/tmp/issue-2", background=true, pty=true)

# すべてを監視
process(action="list")

マルチモデルモード

Blackbox の独特な機能は、同じタスクを複数のモデルで実行し、結果をジャッジすることです。blackbox configure 経由で使用するモデルを設定します — 複数のプロバイダーを選択して Chairman/ジャッジワークフローを有効にします。このワークフローでは CLI が異なるモデルからの出力を評価し、最良のものを選択します。

主要フラグ

フラグ	効果
--prompt "task"	非インタラクティブなワンショット実行
--resume-checkpoint "tag"	保存されたチェックポイントから再開
--yolo	すべてのアクションとモデル切り替えを自動承認
blackbox session	インタラクティブチャットセッションを開始
blackbox configure	設定、プロバイダー、モデルを変更
blackbox info	システム情報を表示

ビジョンサポート

Blackbox は入力内の画像を自動検出し、マルチモーダル分析に切り替えることができます。VLM モード:

• "once" — 現在のクエリのみモデルを切り替え
• "session" — セッション全体で切り替え
• "persist" — 現在のモデルに留まる（切り替えなし）

トークンリミット

.blackboxcli/settings.json でトークン使用量を制御:

{
  "sessionTokenLimit": 32000
}

ルール

1. 常に pty=true を使用 — Blackbox CLI はインタラクティブターミナルアプリであり、PTY がないとハングします
2. workdir を使用 — エージェントを正しいディレクトリに集中させます
3. 長時間タスクにはバックグラウンドを使用 — background=true を使用し、process ツールで監視します
4. 干渉しないでください — poll/log で監視し、遅いからといってセッションをキルしないでください
5. 結果を報告してください — 完了後、何が変更されたかを確認し、ユーザーに要約を報告してください
6. クレジットはお金がかかります — Blackbox はクレジットベースのシステムを使用しており、マルチモデルモードはクレジットをより速く消費します
7. 前提条件を確認してください — 委譲を試みる前に、blackbox CLI がインストールされていることを確認してください