Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

CLI Usage

ankurCES edited this page Jun 7, 2026 · 6 revisions

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 / doctorGPU 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).

Clone this wiki locally

AltStyle によって変換されたページ (->オリジナル) /