Complete reference for all BLACKBOX CLI commands and keyboard shortcuts.

Core Commands

CommandDescription
blackbox configureConfigure Blackbox settings
blackbox infoDisplay Blackbox information
blackbox mcpRun one of the mcp servers bundled with blackbox
blackbox sessionStart or resume interactive chat sessions [aliases: s]
blackbox projectOpen the last project directory [aliases: p]
blackbox projectsList recent project directories [aliases: ps]
blackbox runExecute commands from an instruction file or stdin
blackbox recipeRecipe utilities for validation and deeplinking
blackbox scheduleManage scheduled jobs [aliases: sched]
blackbox updateUpdate the blackbox CLI version
blackbox benchEvaluate system configuration across a range of practical tasks
blackbox webExperimental: Start a web server with a chat interface
blackbox helpPrint this message or the help of the given subcommand(s)

Installation Commands

Platform-specific installation commands:

Unix/Linux/macOS

curl -fsSL https://shell.blackbox.ai/api/scripts/omni-cli/download.sh | bash

Windows (PowerShell)

Invoke-WebRequest -Uri "https://shell.blackbox.ai/api/scripts/omni-cli/download.ps1" -OutFile "download.ps1"; .\download.ps1

Configuration Commands

Set up and manage your BLACKBOX CLI configuration:
# Initial configuration
blackbox configure

Keyboard Shortcuts

General Controls

ShortcutDescriptionContext
Ctrl+CCancel current input or generationStandard interrupt / Exit BLACKBOX CLI session
Ctrl+DExit BLACKBOX CLI sessionEOF signal
Ctrl+LClear terminal screenKeeps conversation history
Up/Down arrowsNavigate command historyRecall previous inputs

Multiline Input

MethodShortcutContext
Quick escape\ + EnterWorks in all terminals
macOS defaultOption+EnterDefault on macOS
Control sequenceCtrl+JLine feed character for multiline
Paste modePaste directlyFor code blocks, logs