CLI reference

hipmmcode [OPTIONS] [PROMPT]... [COMMAND]

No arguments → interactive REPL. A positional prompt (or piped stdin) → headless exec.

Subcommands

Command	Purpose
chat	Interactive session (default). --legion <name>, --as <agent>
exec [prompt]	One-shot headless run (--json, --stream, --max-turns)
resume [id]	List recent sessions, or restore one
config show|set|providers	Inspect / set configuration
model [channel]	Interactive channel setup wizard
models [--all] [--json]	List models per channel (live discovery)
doctor [--json]	Environment diagnosis (read-only, no network)
cost [--all] [--json]	Aggregate token usage across sessions
update [--check]	Self-update to the latest release
serve [--port] [--host] [--auth-token] [--gateway] [--gateway-only] …	HTTP/WS server + task queue; optional membership gateway
member create|list|show|set-quota|…	Admin: manage gateway members / activation codes
join <code>	Member side: redeem a one-time code against a gateway
acp [--listen host:port] [--auth-token]	Agent Client Protocol (stdio or WebSocket)
integration	Print the embedded machine-integration handbook
agents [-l legion] [--json]	List agent profiles
agent new|list	Author / list agent profiles
legions [--json]	List legions
team list|rm <name> [-f]	Manage teams
skills [-l legion] [--json]	List skills
skill add <src> [--name]|list|rm <name>	Install / remove skills
skill install-defaults (defaults) [--force] [--dry-run]	Sync L1 default skills pack into ~/.hipmmcode/skills/
plugin list|details|add|init|install|uninstall|enable|disable|marketplace …	Plugins & marketplaces
commands [--json]	List custom markdown slash commands
mcp add|add-json|add-mcpb|list|get|login|remove|sync|reset-project-choices	MCP servers
cron daemon [--interval]|list [--json]	Durable scheduled tasks
daemon run|status|logs|stop|stop-service|uninstall …	Background-session supervisor (see below)
flags [--json]	Experimental feature flags
completions <shell>	Shell completion script (bash / zsh / fish / elvish / powershell)

Global flags

Accepted on every invocation.

Model & session

Flag	Description
-p, --provider <id>	Channel for this run
-m, --model <id>	Model (bare alias, canonical id, or provider/model)
--fallback-model <id>	Fallback model(s), tried in order (repeatable, ≤3)
-C, --cwd <dir>	Working directory
-c, --continue	Resume the most recent session
--resume <id|name>	Resume a specific session
--fork-session	Resume into a new branched session
--resume-session-at <n>	Rewind to just after the Nth user turn
--session-id <id>	Write to a specific session id
--all	Sessions/cost across all projects

Output & input

Flag	Description
--output-format text|json|stream-json	Output envelope (--json / --stream are shorthands)
--input-format text|stream-json	stream-json = SDK host mode
--print	Force non-interactive mode
--verbose	Verbose output
--include-partial-messages	Per-token frames (stream-json)
--include-hook-events	Hook lifecycle frames (stream-json)
--prompt-suggestions	Predicted next-user-message frames
--replay-user-messages	Echo user turns as frames
--json-schema <schema>	Validate the answer against a JSON Schema (with retry)

Limits & autonomy

Flag	Description
--max-turns <n>	Tool-iteration cap (default 200)
--max-budget-usd <x>	Hard spend ceiling
--goal <condition>	Auto-continue until an evaluator model confirms the condition
--auto-memory	End-of-run memory extraction
--no-memory	Skip memory injection
--no-session-persistence	Don't save the session (headless)

Permissions

Flag	Description
--permission-mode default|acceptEdits|plan|auto|bypassPermissions|dontAsk	Session permission mode; bypass requires dangerous availability
--dangerously-skip-permissions	= bypassPermissions
--permission-webhook <url>	POST ask-decisions to a service
--permission-prompt-tool <tool>	Route decisions to an MCP tool
--ask-webhook <url>	POST AskUserQuestion calls to a service

Prompt & tools

Flag	Description
--system-prompt <text> / --system-prompt-file <f>	Replace the system prompt (exec only)
--append-system-prompt <text> / --append-system-prompt-file <f>	Append to it
--dump-system-prompt	Print the assembled prompt and exit
--exclude-dynamic-system-prompt-sections	Better prompt-cache reuse
--allowed-tools <names> / --disallowed-tools <names>	Tool allow/deny lists
--add-dir <dir>	Extra directory for file/shell tools (repeatable)
--agents <json>	Session-only agent profiles
--mcp-config <file|json>	Extra MCP servers for this run (repeatable)
--strict-mcp-config	Use only --mcp-config servers
--settings <file|json>	Extra settings layer
--setting-sources user,project,local	Restrict settings layers
--ide	Connect to a running IDE for diagnostics
--bare	Fast start: skip skills/MCP/hooks; tools narrowed to Bash+Read+Edit
--safe-mode	Disable all customizations (troubleshooting)

Daemon

The daemon subcommand manages the background-session supervisor (durable workers independent of any one TUI). Paths default under the native config root (daemon.json / daemon.log).

Action	Purpose
daemon run	Run the supervisor in the foreground
daemon status	Pid, version, uptime, socket, worker roster
daemon logs	Print the daemon log
daemon stop [--any] [--keep-workers]	Shut down the supervisor (--any also stops a transient on-demand daemon)
daemon stop-service <name> [--force]	v0.16.0+. Stop a single named service (pkill-based) without restarting the whole daemon; --force sends SIGKILL
daemon uninstall	Remove stale service metadata

hipmmcode daemon status
hipmmcode daemon stop-service my-worker
hipmmcode daemon stop-service my-worker --force

Exit codes

Code	Meaning
0	Success
1	Error (flag / config / auth / network)
2	Bad JSON argument, or a hook blocked the action
non-zero	Max-turns cap, budget ceiling, or schema-validation exhaustion

Shell completions

hipmmcode completions zsh  > ~/.zfunc/_hipmmcode
hipmmcode completions bash > /usr/local/etc/bash_completion.d/hipmmcode
hipmmcode completions fish > ~/.config/fish/completions/hipmmcode.fish