命令行与子命令

Mogick CLI 提供三个运行入口：mogick 启动交互式 TUI，mogick run 执行一次性任务，mogick acp 通过 stdio JSON-RPC 接入支持 ACP 的宿主。其余子命令用于管理会话、MCP、诊断、升级和插件。

命令总览

命令	用途
mogick	启动交互式 TUI
mogick run [PROMPT]	非交互执行一次任务；也可用 - 从 stdin 读取 prompt
mogick acp	启动 ACP Runtime
mogick sessions	管理会话、导出历史
mogick mcp	查看或配置 MCP 服务器
mogick setup	通过 OAuth 设备码登录，并写入全局认证凭据
mogick logout	清除生效全局认证中的 OAuth 凭据，保留 API Key
mogick setup skill	配置新建 Skill 的默认写入位置
mogick doctor	检查配置、认证、运行环境和网络
mogick upgrade	检查并安装更新
mogick version	输出版本信息
mogick completion	生成 Shell 补全脚本
mogick plugin	管理 MWorks 等插件

mogick --resume <session-id>
mogick run "fix all lint errors"
echo "explain this" | mogick run -
mogick run "generate a commit message" -o msg.txt

mogick run

run 固定使用 Agent 模式。26.9.11 中，-o 实际重定向运行渲染器输出，并非仅最终答案；结合 --json 时写入 JSONL 事件。见一次性执行。

参数	说明
--json	输出 JSON 事件
-o, --output-last-message <file>	将运行输出写入文件（26.9.11 行为）
--non-interactive	禁止交互提示；stdin 为管道时自动启用
--resume <id>	在指定会话中继续执行
--tool-call-permissions <policy>	使用 read、workspace、auto 或 yolo 权限策略
--verbose	输出详细工具 trace
--logs-path <file>	指定诊断日志文件
--no-auto-upgrade	跳过启动时的更新检查
--yolo	已弃用；改用 --tool-call-permissions yolo

mogick run --tool-call-permissions read "Review the source code without changing files"

workspace 不会自动放行任意 Shell 命令。非交互运行中，需要审批的调用会被拒绝。应独立执行项目明确的测试命令并检查结果，不能把 Agent 正常结束当成测试通过。

mogick sessions

使用 mogick sessions list 列出当前工作区的会话。--json 是 sessions 的持久参数，可用于其支持 JSON 输出的子命令。

子命令	说明
list	列出会话，包括状态为 closed 的记录
create [title]	创建会话
rename <id> <title>	重命名会话
delete <id>	删除会话及关联的持久化记录，包括历史；不是标记为 closed，成功后不能再恢复或导出该会话
feedback <id> <run-id> <like|dislike>	提交反馈；dislike 可附加 --reason
export <id>	导出可读历史；加 sessions --json 输出 JSON

mogick sessions list
mogick sessions export abc123
mogick sessions --json export abc123

导出格式与限制见会话导出选项。

mogick mcp

MCP 配置从全局 <config-dir>/mcp.json 和项目 .mogick/mcp.json 加载；同名服务器以高优先级定义整体覆盖。

子命令	说明
list	列出配置、启用状态和来源；不验证连接
setup	交互配置服务器

mogick mcp list
mogick mcp setup

mogick doctor

doctor 默认渲染 Markdown 诊断报告。

参数	说明
--json	输出 JSON
--format md|json	指定报告格式
--export <path>	将原始报告写入文件
--check-network	检查网络服务连通性
--check-terminal-font	交互检查终端字体与字符显示
--all	同时执行网络和终端检查
--verbose	输出详细信息
--logs-path <file>	指定日志文件

mogick doctor
mogick doctor --json
mogick doctor --format md
mogick doctor > ./diagnostics.md
mogick doctor --format json --export ./diagnostics.json
mogick doctor --check-network
mogick doctor --check-terminal-font

setup、升级、版本与补全

mogick setup 保存 OAuth 凭据，并补齐缺失的官方 provider、默认模型和轻量模型配置，不覆盖明确配置的模型选择。mogick logout 清理生效的全局认证文件中的 OAuth 凭据，保留 API Key 和项目凭据。见认证与模型。

mogick upgrade --dry 只检查更新，不安装。mogick version --verbose 输出更完整的构建信息。completion 支持 Cobra 提供的 Shell，包括 bash、zsh、fish 和 PowerShell。

mogick setup
mogick upgrade
mogick upgrade --dry

mogick plugin

使用以下命令查看已安装插件；本页不展开安装与恢复流程。

mogick plugin list
mogick plugin inspect <plugin-id>

Root 参数

只有 --no-auto-upgrade 是持久参数。其他参数应放在 root 或对应子命令后。

参数	Root	run	acp
--verbose	✓	✓	✓
--logs-path <file>	✓	✓	✓
--no-auto-upgrade	✓	✓	继承
--non-interactive	✓	✓	—
--resume <id>	✓	✓	—
--continue	✓	✓	—
--tool-call-permissions <policy>	✓	✓	—
--yolo（已弃用）	✓	✓	—
--json	—	✓	—
-o, --output-last-message <file>	—	✓	—

参数取值和行为见命令行参数。

路径占位符 <config-dir>、<db-path> 指当前 profile/通道实际生效的路径，见数据目录。