Mogick CLI 功能总览
Mogick CLI 是 MWORKS AI Agent 的统一命令行运行时，在本地终端中运行，能够读取、修改和执行代码。它将大语言模型的推理能力与本地工具链深度结合，让开发者可以直接在终端中完成代码生成、调试、重构等任务，无需离开工作环境。
入口
Mogick CLI 提供三种运行入口，覆盖从日常开发到自动化流水线的不同场景：
| 命令 | 说明 |
|---|---|
mogick | 交互式 TUI 会话，采用 Plan → Approve → Execute 工作流，适合探索性开发与日常使用 |
mogick run "PROMPT" | 非交互执行，支持管道输入，面向 CI/CD 与脚本自动化 |
mogick acp | stdio JSON-RPC 协议，供 IDE、桌面端等宿主程序集成 |
日常开发中直接运行 mogick 进入交互会话最为常用；而在持续集成流水线中，mogick run 可以直接接收任务描述并返回结果，无需人工介入。mogick acp 则面向需要将 Agent 能力嵌入现有工具的集成场景。
核心能力
文件与 Shell 操作：CLI 内置 file.read、file.write、file.edit 和 shell.exec 等工具，可以直接读写项目文件并执行 Shell 命令。Agent 能够理解项目结构，在正确的上下文中做出精准修改。
Git 集成：CLI 具备完整的仓库感知能力，内置 git.status、git.diff、git.log 和 git.show 等操作。Agent 可以查看变更历史、分析差异，并在需要时创建分支和提交，让版本控制融入每一次交互。
MCP 扩展：通过 Model Context Protocol 接入外部工具与数据源，支持 stdio、HTTP 和 SSE 三种传输方式。这使得 CLI 的能力边界可以通过 MCP 服务端灵活扩展，不受内置工具集的限制。
权限控制：CLI 提供四级细粒度权限模型（read / workspace / auto / yolo），控制工具执行时的人工确认策略。
会话管理：支持会话的创建、恢复、重命名、删除和导出。恢复时加载已保存的历史和设置；外部环境、未保存内容及压缩前上下文不保证原样恢复。
检查点与回退：默认每轮请求前尝试创建检查点，受保护的文件修改另记录回退前像。/rewind 命令可将工作区和对话历史回退到可恢复的检查点，让你安全地探索不同方案，出错后可快速回到已知良好状态。
上下文压缩：在对话历史过长时自动触发压缩，也可通过 /compact 手动执行。压缩通过摘要控制 token 消耗，可能丢失细节；重要约束应保留在项目文件中。
L3 长期记忆：跨会话的记忆机制，通过检索注入和自动抽取，让 Agent 记住项目约定、用户偏好和历史决策。随着使用次数增加，Agent 对项目的理解会持续加深。
此外，CLI 还提供实验性子代理功能（agent.task），可在父任务内拆分并行子任务以提升效率；启动时自动在后台检查新版本并在 TUI 中提示升级；以及按安装和配置提供的插件能力。
快速开始
三条命令即可覆盖最常用的场景：
# 启动交互会话
mogick
# 非交互执行
mogick run "fix lint errors"
# 诊断环境
mogick doctor首次使用建议先运行 mogick doctor 检查环境配置，确认所有依赖就绪后再启动交互会话。