CLI 参考

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

无参数 → 交互 REPL。位置提示词(或管道 stdin)→ 无头 exec。

子命令

命令	用途
chat	交互会话(默认)。--legion <name>、--as <agent>
exec [prompt]	一次性无头运行(--json、--stream、--max-turns)
resume [id]	列出最近会话,或恢复某个
config show|set|providers	查看 / 设置配置
model [channel]	交互式渠道配置向导
models [--all] [--json]	逐渠道列模型(实时发现)
doctor [--json]	环境诊断(只读,不联网)
cost [--all] [--json]	跨会话聚合 token 用量
update [--check]	自更新到最新版
serve [--port] [--host] [--auth-token] [--gateway] [--gateway-only] …	HTTP/WS 服务器 + 任务队列;可选会员网关
member create|list|show|set-quota|…	管理端:网关成员 / 激活码
join <code>	成员端:用一次性激活码加入网关
acp [--listen host:port] [--auth-token]	Agent Client Protocol(stdio 或 WebSocket)
integration	打印内嵌机器集成手册
agents [-l legion] [--json]	列智能体画像
agent new|list	创建 / 列出智能体画像
legions [--json]	列军团
team list|rm <name> [-f]	管理团队
skills [-l legion] [--json]	列技能
skill add <src> [--name]|list|rm <name>	安装 / 卸载技能
skill install-defaults(defaults)[--force] [--dry-run]	将 L1 默认技能包同步到 ~/.hipmmcode/skills/
plugin list|details|add|init|install|uninstall|enable|disable|marketplace …	插件与市场
commands [--json]	列自定义 markdown 斜杠命令
mcp add|add-json|add-mcpb|list|get|login|remove|sync|reset-project-choices	MCP 服务器
cron daemon [--interval]|list [--json]	持久定时任务
daemon run|status|logs|stop|stop-service|uninstall …	后台会话 supervisor(见下)
flags [--json]	实验特性开关
completions <shell>	Shell 补全脚本(bash / zsh / fish / elvish / powershell)

全局 flag

任意调用都接受。

模型与会话

Flag	说明
-p, --provider <id>	本次运行的渠道
-m, --model <id>	模型(裸别名、规范 id 或 provider/model)
--fallback-model <id>	回退模型,按序尝试(可重复,≤3)
-C, --cwd <dir>	工作目录
-c, --continue	继续最近会话
--resume <id|name>	恢复指定会话
--fork-session	以分叉的新会话续接
--resume-session-at <n>	回退到第 N 个用户回合之后
--session-id <id>	写入指定会话 id
--all	会话/费用跨所有项目

输出与输入

Flag	说明
--output-format text|json|stream-json	输出信封(--json / --stream 是简写)
--input-format text|stream-json	stream-json = SDK 宿主模式
--print	强制非交互
--verbose	详细输出
--include-partial-messages	逐 token 帧(stream-json)
--include-hook-events	hook 生命周期帧(stream-json)
--prompt-suggestions	预测下一条用户消息的帧
--replay-user-messages	回显用户回合为帧
--json-schema <schema>	用 JSON Schema 校验回答(带重试)

上限与自治

Flag	说明
--max-turns <n>	工具迭代上限(默认 200)
--max-budget-usd <x>	硬性花费上限
--goal <条件>	自动续跑直到评估模型确认条件达成
--auto-memory	运行结束时提炼记忆
--no-memory	跳过记忆注入
--no-session-persistence	不保存会话(无头)

权限

Flag	说明
--permission-mode default|acceptEdits|plan|auto|bypassPermissions|dontAsk	会话权限模式;bypass 需要危险模式可用
--dangerously-skip-permissions	= bypassPermissions
--permission-webhook <url>	ask 决策 POST 给服务
--permission-prompt-tool <tool>	决策路由给 MCP 工具
--ask-webhook <url>	AskUserQuestion POST 给服务

提示与工具

Flag	说明
--system-prompt <text> / --system-prompt-file <f>	替换系统提示(仅 exec)
--append-system-prompt <text> / --append-system-prompt-file <f>	追加
--dump-system-prompt	打印组装后的提示并退出
--exclude-dynamic-system-prompt-sections	提升 prompt 缓存复用
--allowed-tools <names> / --disallowed-tools <names>	工具白/黑名单
--add-dir <dir>	文件/shell 工具的额外目录(可重复)
--agents <json>	仅本会话的智能体画像
--mcp-config <file|json>	本次运行的额外 MCP 服务器(可重复)
--strict-mcp-config	只用 --mcp-config 的服务器
--settings <file|json>	额外 settings 层
--setting-sources user,project,local	限制 settings 层
--ide	连接运行中的 IDE 获取诊断
--bare	快速启动:跳过技能/MCP/hooks;工具收窄到 Bash+Read+Edit
--safe-mode	禁用全部自定义(排障)

Daemon

daemon 子命令管理后台会话 supervisor(与单个 TUI 无关的持久 worker)。路径默认在原生配置根下(daemon.json / daemon.log)。

动作	用途
daemon run	前台运行 supervisor
daemon status	pid、版本、uptime、socket、worker 花名册
daemon logs	打印 daemon 日志
daemon stop [--any] [--keep-workers]	关闭 supervisor(--any 也会停掉按需起的 transient daemon)
daemon stop-service <name> [--force]	v0.16.0+。 按名停止单个服务(pkill),不必重启整个 daemon;--force 发 SIGKILL
daemon uninstall	清理陈旧 service 元数据

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

退出码

码	含义
0	成功
1	错误(flag / 配置 / 认证 / 网络)
2	JSON 参数不合法,或 hook 阻断
非零	max-turns 上限、预算上限、或 schema 校验耗尽

Shell 补全

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