-
Notifications
You must be signed in to change notification settings - Fork 0
CLI Usage
ankurCES edited this page Jun 7, 2026
·
6 revisions
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.
| 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"
-
entersend ·/command palette ·^ppalette ·tabfocus ·escnav -
^btoggle rails ·^yYOLO (auto-approve) ·^cquit - 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
-
/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,esccancels. 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 clonea 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 +$ savedvs all-heavy./route off|heuristic|hybrid|judgeswitches 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).
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.
| 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
|
-
--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 thedockerfeature).