CLI Usage

CLI Usage

Run blumi <command> --help for the full flags of any subcommand.

blumi [--provider P] [--model M] [--persona NAME] [--sandbox local|docker] [COMMAND]

With no command on a TTY, blumi launches the TUI.

Core

Command	Description
blumi / blumi tui	Interactive terminal UI
blumi run "<prompt>"	Run one prompt headlessly, streaming to stdout (pipeable)
blumi login	Setup wizard: provider, key/endpoint, model
blumi web	Embedded React web UI + HTTP/SSE server
blumi serve …	Always-on gateway for the phone app → Gateway

echo "summarize this diff" | blumi run -          # read prompt from stdin
git diff | blumi run "review these changes" --yolo
blumi --persona reviewer run "audit src/auth.rs"

TUI essentials

• enter send · / command palette · ^p palette · tab focus · esc nav
• ^b toggle rails · ^y YOLO (auto-approve) · ^c quit
• Slash: /help /model /persona /theme /memory /usage /tasks /yolo /compact /undo /sessions /new /resume /quit
• More slash: /open-workspace · /new-workspace · /clone-workspace · /heal · /route · /discoveries · /memories · /knowledge · /accel · /grid

Workspaces, cost, autonomy & hardware (TUI)

• /open-workspace — a file-browser popup to open any folder as a workspace. ↑/↓ move, → enter a folder, ←/backspace go up, space opens the highlighted folder (keep browsing), enter opens + closes, esc cancels. Git repos are flagged; opened folders appear in the left workspace pane and are remembered as recents.
• /new-workspace <path> — create a folder (+ git init) and open it as a workspace.
• /clone-workspace <url> [dir] — git clone a repo (dir defaults to the repo name) and open it.
• /heal — a self-healing summary: recovery / evolution / proposal counts + recent items. See Self-Management → Self-healing.
• /route — cost-aware routing: per-tier counts + $ saved vs all-heavy. /route off|heuristic|hybrid|judge switches the mode live. See Self-Management → Cost-aware routing.
• /discoveries — tasks the always-on pass proposed (and where reports land). See Self-Management → Always-on discovery.
• /memories — browse semantic long-term memory: per-entry namespace / kind / utility / hit-count, with pinned entries marked ★. Read-only (the web Control Center edits them). Distinct from /memory, which views the MEMORY.md / USER.md files. See Memory & Knowledge.
• /knowledge — the code knowledge base: indexed files / symbols / vectors + per-source counts. See Memory & Knowledge.
• /accel — the active accelerator (Apple CoreML / NVIDIA CUDA / CPU) for this node. See Memory & Knowledge → GPU acceleration.
• /grid — live grid metrics (peers, tasks, tokens, strongest accelerator).

Task board + autonomous loop

blumi task add "write tests for parser" -p 1     # add a task (priority 1=highest)
blumi task list                                  # show the board
blumi loop --max 5 --yolo                        # work the board: select → run → advance

The loop pulls the highest-priority todo, runs it as a turn, and advances it. Bound it with --max <n> and --budget <usd>; --review sends finished tasks to review instead of done. On a grid it can hand tasks off to peers.

Management & automation

Command	Description
blumi session	List / search / show stored sessions (FTS5 full-text search)
blumi stats	Aggregate token usage across sessions
blumi cron	Schedule prompts on a timer
blumi playbook <file.yaml>	Run a multi-step workflow with gates + resume
blumi skills	Manage the bundled SKILL.md library + your own → Self-Management
blumi mcp	Manage MCP servers (defaults + a catalog)
blumi gateway	Run as a messaging bot (Telegram/Discord/Slack/WhatsApp)
blumi accel	Inspect the GPU/accelerator: detect / status / doctor → GPU acceleration

Global flags

• --provider / --model — override the LLM for this run.
• --persona — start with a named persona.
• --sandbox local|docker — run tools on the host or in a container (needs the docker feature).