Reference

CLI Reference

Run minnal --help at any time for the full reference. The most common commands and flags are below.

Top-level commands

Command	Description
`minnal`	Start the TUI in the current directory
`minnal run <message>`	Run a one-shot message non-interactively
`minnal --resume <name>`	Resume a session by memorable name
`minnal serve`	Start the persistent core server
`minnal connect`	Attach a TUI client to a running server
`minnal dictate`	Voice input via your configured STT command
`minnal login --provider <name>`	OAuth or API-key login for a provider
`minnal models [provider]`	List available models
`minnal mcp <add\|remove\|list\|logs>`	Manage MCP servers
`minnal skill <add\|remove\|list>`	Manage Skills
`minnal sessions`	List, search, export sessions
`minnal upgrade [version]`	Upgrade to latest or pinned version
`minnal uninstall`	Remove minnal and its data dir
`minnal channel use <stable\|current\|canary>`	Switch install channel
`minnal --version`	Print the version

Flag	Description
`--help, -h`	Show help
`--version, -v`	Show version
`--print-logs`	Mirror logs to stderr
`--log-level <level>`	error \| warn \| info \| debug \| trace
`--config <path>`	Use an alternative config file
`--no-telemetry`	Disable telemetry for this run

Command	Effect
`/new`	Start a new session
`/sessions`	Switch session
`/resume`	Resume a previous session
`/rename <name>`	Rename the current session
`/fork`	Fork from the current message
`/compact`	Summarize and compact the transcript
`/undo`	Undo the previous message
`/redo`	Redo the previous undo
`/export`	Export session as JSON
`/share`	Share the session via signed URL

Command	Effect
`/connect`	Add or switch a model provider
`/models`	Pick a model
`/model <id>`	Switch to a model by id
`/agents`	Switch agent persona
`/mcps`	Toggle MCP servers
`/skills`	Activate/deactivate skills

Command	Effect
`/init`	Generate AGENTS.md for this repo
`/plan`	Switch to plan-only mode (no edits)
`/self-dev`	Enter Self-Dev mode
`/swarm`	Spawn or attach to a swarm
`/dm <agent> <msg>`	DM another agent in the swarm
`/broadcast <msg>`	Broadcast to all agents on the server
`/memory <search\|store> ...`	Memory tools
`/alignment <left\|center>`	Change UI alignment (also Alt+C)

Keys	Action
`Enter`	Send message (interleaves with the running turn)
`Shift+Enter`	Queue message until current turn finishes
`Tab`	Toggle plan mode
`Alt+C`	Toggle centered alignment
`Ctrl+R`	Search session history
`Ctrl+C`	Cancel current turn
`Ctrl+D`	Exit

0  success
1  generic error
2  user cancelled
3  provider auth error
4  config error
5  build / self-dev failure