Поручение задач по программированию CLI-инструменту Blackbox

Как применить

CLI-инструмент Blackbox установлен: npm install -g @blackbox_ai/blackbox-cli (бинарник: blackbox)

Выполните команду blackbox configure и введите свой API-ключ для завершения настройки.

В вызовах терминала используйте параметр pty=true — Blackbox CLI представляет собой интерактивное приложение для терминала.

Чтобы выполнить задачу однократно, воспользуйтесь командой --prompt "task" (-p); это позволит запустить её в неинтерактивном режиме.

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)

Для длительных задач используйте фоновый режим.

Если задача занимает несколько минут, применяйте фоновый режим, чтобы иметь возможность отслеживать её ход.

# Start in background with PTY
terminal(command="blackbox --prompt 'Refactor the auth module to use OAuth 2.0'", workdir="~/project", background=true, pty=true)
# Returns session_id

# Monitor progress
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")

# Send input if Blackbox asks a question
process(action="submit", session_id="<id>", data="yes")

# Kill if needed
process(action="kill", session_id="<id>")

После завершения задачи можно продолжить с сохранённой точки останова с помощью команды --resume-checkpoint "tag" и соответствующего запроса.

# After a task completes, Blackbox shows a checkpoint tag
# Resume with a follow-up task:
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 прерывает текущую операцию.

Для проверки pull-request сначала склонируйте репозиторий во временный каталог.

Склонируйте репозиторий во временный каталог, чтобы не изменять рабочую директорию.

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 в фоновом режиме — по одному на каждую независимую задачу — и отслеживайте их все с помощью команды process(action=list).

Запускайте несколько экземпляров 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)

# Monitor all
process(action="list")

Blackbox может выполнять одну и ту же задачу через несколько моделей и оценивать результаты: настройте используемые модели с помощью команды blackbox configure, выберите несколько провайдеров, чтобы включить режим работы Chairman/judge, при котором CLI анализирует выводы разных моделей и выбирает наилучший вариант.

Ключевые флаги: --prompt "task" (-p) запускает одноразовую неинтерактивную задачу; --resume-checkpoint "tag" возобновляет работу с сохранённой точки останова; --yolo (-y) автоматически подтверждает все действия и переключения моделей; --vlm-switch-mode <mode> задаёт режим обработки изображений (once, session или persist); -c, --checkpointing включает сохранение состояния при редактировании файлов; blackbox configure изменяет настройки, провайдеров и модели; blackbox update обновляет CLI до последней версии; blackbox mcp управляет серверами MCP; blackbox extensions управляет расширениями CLI; blackbox voice <action>/blackbox shortcut настраивают голосовой ввод и сочетание клавиш b.

Blackbox автоматически распознаёт изображения во входных данных и может переключаться на мультимодальный анализ. Режимы VLM: "once" переключает модель только для текущего запроса.

"session" переключает модель на всю сессию.

"persist" оставляет текущую модель без переключения.

Управляйте использованием токенов через .blackboxcli/settings.json, например, устанавливая лимит токенов на сессию.

Управляйте использованием токенов через .blackboxcli/settings.json.

{
  "sessionTokenLimit": 32000
}

Всегда используйте pty=true — Blackbox CLI — это интерактивное терминальное приложение, которое зависнет без PTY.

Используйте workdir, чтобы направить агента в нужную директорию.

Для длительных задач запускайте их в фоновом режиме с помощью background=true и отслеживайте с помощью инструмента process.

Не вмешивайтесь — отслеживайте процесс с помощью poll/log и не прерывайте сессии лишь из-за их медленной работы.

После завершения проверьте, что изменилось, и подготовьте краткий отчёт для пользователя.

Кредиты стоят денег: Blackbox использует систему на основе кредитов, а режим мультимодельного анализа расходует кредиты быстрее.

Проверьте необходимые условия перед началом работы: убедитесь, что CLI blackbox установлен.

Ссылки

• Blackbox AI