命令行参数

只有 --no-auto-upgrade 是持久参数，可由子命令继承。其他参数属于 root 或具体子命令，应写在对应命令之后。已经移除的 -C / --cd、-c / --config、--silent 和 run --mode 不再受支持。

Root、run 与 ACP

参数	短标志	取值	默认值	适用范围	说明
--verbose	—	—	false	root / run / acp / doctor	输出详细工具 trace 或诊断信息
--logs-path	—	文件路径	—	root / run / acp / doctor	诊断日志文件路径
--no-auto-upgrade	—	—	false	持久参数；run 也显式提供	禁止启动时检查更新
--non-interactive	—	—	false	root / run	root 下打印帮助；run 下禁用提示
--resume	—	会话 ID	—	root / run	恢复指定会话
--continue	—	—	false	root / run	恢复最近活跃会话；不能与 --resume 同用
--tool-call-permissions	—	read / workspace / auto / yolo	auto	root / run	工具权限策略
--yolo	—	—	false	root / run	已弃用；改用 --tool-call-permissions yolo
--json	—	—	false	run	输出 JSON 事件
--output-last-message	-o	文件路径	—	run	写入运行输出（26.9.11）

run 使用 Agent 模式。26.9.11 的 -o 保存渲染器输出，而非仅最终消息；结合 --json 时写入 JSONL，见一次性执行。

mogick run --non-interactive --json --output-last-message run.jsonl "Check code risks"

执行模式

TUI 中按 Shift+Tab 切换 Agent 和 Plan；ACP 宿主通过协议切换。Plan 模式提供只读文件与 Git 探索、Skill 查找和加载、提问、任务列表、计划读写及可用的本地代码搜索，不允许文件写入、Shell、MCP 或其他网络操作。

Plan 完成后，模型调用 plan.write 并结束当前轮次，由 TUI 或 ACP 宿主发起确认和模式切换。Plan 流程不使用 plan.exit 工具。

mogick --continue

工具权限策略

策略	行为
read	自动放行只读工具及部分仅修改 Mogick 内部状态的安全工具
workspace	在 read 基础上，自动放行工作区内非删除的 file.write / file.edit
auto	默认策略；安全操作自动放行，其余调用进入审批
yolo	自动批准需要确认的工具；显式 deny 仍然生效

非交互执行遇到必须人工确认的操作时不会等待输入。CI 中应按任务风险明确选择 read、workspace 或隔离环境中的 yolo。

mogick run --tool-call-permissions yolo "Refactor controller error handling"

sessions 参数

--json 是 sessions 持久参数；sessions feedback ... dislike 可加 --reason。导出支持可读历史或 JSON，不再提供旧的上下文、协议、Git、子代理导出模式，见会话导出。检查点通过 TUI /rewind 操作；26.9.11 没有 sessions checkpoint 子命令。

doctor 参数

参数	说明
--json	输出 JSON
--format md|json	显式指定格式
--export <path>	写入原始诊断报告
--check-network	探测网络服务
--check-terminal-font	交互检查终端字符显示
--all	执行全部额外检查
--verbose	输出详细诊断
--logs-path <file>	指定日志文件

日志与升级

--logs-path 接收文件路径，不是目录。--no-auto-upgrade 禁止启动时检查更新。

mogick --logs-path ./mogick-debug.json --verbose --no-auto-upgrade