English | 简体中文

MoCode

一个终端编码 agent:你给一个目标,它自主完成——不需要你逐步指挥。

mocode 自己探索代码、读写改文件、执行命令、联网查资料,以「思考 → 调用工具 → 观察结果 → 再思考」的循环一步步把任务推进到完成。接任意 OpenAI 兼容接口(GLM、DeepSeek、Qwen、本地 Ollama / vLLM 等),全屏 TUI 交互,流式输出、思考过程可见。

演示

看 mocode 自主完成真实任务：

修自己仓库的文档漂移 —— mocode 逐个数清 src/tools/builtins/index.ts 里的实际工具数，发现 package.json 和 AGENTS.md 的描述不一致，自动改齐并跑测试验证。

从零做一个网页应用，自己截图反复改到满意 —— mocode 用原生 HTML/CSS/JS（不引第三方库）+ Web Audio API 完成一个番茄钟，再调用 dev_server + browser + screenshot 检查渲染效果，发现布局问题就改代码再截图，直到满意。

效率:更快、更省 token

• 两级模型面板 — 裸 /model 先列厂商、Enter 进入后再选模型;搜索是作用域内过滤——顶层只匹配厂商名,厂商内只匹配模型名,不再把厂商和模型混在一个结果里。
• 思考强度 /effort — off / low / medium / high / auto 五档归一,按目标模型自动翻译成各家方言(Anthropic / OpenAI o·gpt-5 / Qwen3 / GLM / DeepSeek-R1 / 豆包);不认识的模型或第三方网关不下发未知字段,避免 400。
• 用量统计 /stats — 本会话缓存命中率、分层 token 用量与压缩次数,基于后端真实上报,不靠估算。
• 缓存安全的压缩分叉 — 能整段复用旧对话时优先走 fork,保住 prompt-cache 前缀、减少重复计费;不满足条件再回落摘要(MOCODE_COMPACT_FORK=false 关闭)。
• 重复读取去重 — 同一轮对同一文件的重复读取命中缓存,不再为相同内容重复付费(MOCODE_READ_DEDUP=false 关闭)。
• 子 Agent 深度闸 — 递归派生默认最多 3 层(SUB_AGENT_MAX_DEPTH 可调),防止子 agent 无限膨胀。

架构

MoCode 是一个分层的自治运行时：终端交互层驱动 Agent 内核，内核通过受控能力平面执行真实操作，持久化认知层则让长任务和跨会话工作保持连贯。

实现入口：Agent 内核、工具派发、工具执行。

自治执行循环

每次模型响应都是闭环中的一步。工具调用按能力声明分类，安全读取可以并行，写操作获取规范化资源锁。工具证据除单条 hard cap 外原样进入 history，用户与模型看到同一事实。agent 没有更多工具调用时立即完成；框架不会暗中运行验证，也不会强迫追加一轮模型调用。

只在真实 Context Pressure 下压缩

正常会话保留完整工具证据，只维护 freshness / provenance 元数据。总上下文达到 80% 时，统一调度事件会执行已启用的 superseded、stale artifact、旧日志/搜索清理，然后始终继续 history compact；Lifecycle 不再按工具调用次数老化正文。

具体行为以预算计算和压力调度实现为准。

多 Agent 协作：共享工作区，有界并发

子 agent 维护独立历史分支，可以复用父级对话前缀，工具能力不能超出父 step 委派的范围。连续的子 agent 调用按并发上限分批执行（SUB_AGENT_CONCURRENCY 默认 10，设为 1 时逐个派发）。

历史隔离不等于文件系统隔离。 子 agent 直接写入共享工作区，并继承父级当前轮次的回滚记录；没有私有文件系统 overlay、每个 worker 独立的 worktree，也没有任务结束后的 ChangeSet 合并阶段。嵌套工具各自获取资源锁，支持的文件编辑各自执行 expected hash 校验；这些保护不意味着整个多步子任务具备事务隔离。主线接收最终摘要、状态、用量和已追踪的改动文件，而不是完整的子任务过程记录。是否验证及验证范围仍由 agent 自主决定。

对应实现：子 agent 执行、sub-agent 工具、能力感知派发。

受控执行:权限门 + 能力调度

每个写入工具在执行前都会经过权限层。工具分为 safe / confirm / dangerous 三档,授权粒度支持 once / session / project / 全局工具四档,指纹使用稳定哈希(命令、路径或参数),持久化记录落在 ~/.mocode/permissions.json(v3 格式,会自动加载 v2 资源授权)。管道/CI 环境默认拒绝所有需确认的操作,除非显式开启。

Agent 自主验证

mocode 不会在任务结束时暗中启动验证瀑布。agent 可以根据任务风险自行调用 run_command 跑聚焦测试、typecheck 或 build；也可以在无需额外证据时直接结束，不产生框架强制的额外轮次。

回滚时间线：追踪文件改动，按轮次恢复

回滚记录支持范围内的文本文件改动，包括子 agent 在父级轮次中产生的已追踪改动。/rollback 在规范化资源锁下恢复已记录的文件内容，不重跑模型，也不自动启动测试。它不是通用撤销机制：网络副作用、桌面操作、二进制改动及其他未追踪的副作用不在恢复范围内。中断当前轮次不会自动撤销已经完成的文件写入。

快照捕获与恢复边界见回滚存储实现。

上下文控制：一个真实压力线，阶段独立可选

这些控制项仍可独立配置，但自动改写只有一个触发条件：校正后或原始请求占用达到 80%。该事件会运行所有已启用的 pressure 清理，然后始终继续压缩历史。contextLifecycle 只维护 provenance 元数据，EWMA 则让估算持续对齐 provider 实测用量。

桌宠:WebSocket 上的被动镜像

可选 Electron 子包(packages/pet-app)用一个悬浮小角色镜像 agent 状态:单向 WebSocket 推送事件帧,/pet quit 完全关闭。渲染层零业务逻辑,无论桌宠是否在跑,主 agent 循环一字不改。

工程化纪律

mocode 把代码层控制保持得尽量轻，把任务策略交给 agent：

• 建议式工作纪律 — system prompt 只要求聚焦改动、避免重复检索、诚实报告不确定性；是否验证及验证范围由 agent 自主决定，不是完成硬门。
• 有界重试，明确报告失败 — runtime 仅对显式声明 idempotent 的工具瞬时错误自动重试，最多两次；TIMEOUT、权限拒绝、中断和非幂等调用不自动重试。最终结构化结果交给 agent，由其决定后续恢复方式，详见自动重试。
• ask_human 决策与关键修改先问 — 用户尚未做出的决策（存在多个合理方案）和关键修改（公共 API、schema、依赖、文件移动/删除、架构、安全、大范围或不可逆改动）必须先询问用户；只有符合仓库惯例的琐碎细节才由 agent 自行决定。
• 五区上下文控制 + token 自校准 — 独立旋钮管理上下文压力，token 估算根据真实 provider 用量校准。

为什么用 mocode

mocode 不是一个套壳聊天框,而是一个能真正动手干活的 agent:

• 自主多步推进 — 一次对话里连续多步:读代码、改代码、跑测试、根据报错再改……agent 自己决定下一步,中途不用你反复催。遇到决策点或关键修改会先调 ask_human 弹面板问你(阻塞到回应)。
• 能力感知并发 — 连续且声明支持并行的工具（如读文件、grep、glob、联网读取）可并发执行。按资源加锁的文件改动也可同时派发，由规范化资源锁协调冲突资源，而不是把所有写入全局串行化。进程类及未声明并行能力的工具保持各自的串行执行约束。
• 子 agent 分而治之 — 子任务拥有独立历史分支，工具权限不超过父 step 的能力上限；按并发上限分批运行，直接写入共享工作区并共用父级回滚轮次。主线接收最终摘要及执行元数据；没有每个 worker 独立的文件系统隔离或合并阶段。
• 计划 / 执行双模式 — plan 模式下探查并产出计划，不修改项目文件、不跑 shell 命令、不派生子 agent；内部会话和计划记录仍可持久化。auto 模式允许执行，但不是静态“全工具”模式：每个真实用户轮先由轻量 LLM router 选择最小充分工具簇，主模型需要时可在后续 step 追加能力。
• 统一压力驱动压缩 — 正常 history 保留完整工具证据；达到 80% 后由一次调度事件运行所有已启用的清理，并始终继续 history 摘要。/context 显示实时用量，/compact 仍是用户显式覆盖。
• 跨会话长期记忆 — agent 能把项目架构、约定、踩过的坑存成长期记忆,下次会话自动加载;后台反思默认开启（每会话至多 3 次、AUTO_REFLECT=false 可关），从对话中挖掘值得记住的事实,画像事实按来源分级(反思推断先作候选,用户确认才内化);反思还会累计行为证据——候选经多次独立印证且零反驳会自动内化,已内化信念若被后续行为反复相悖则退回候选(每次自动升降级都会提示,用户可用 /memory confirm 翻案)。记忆可增删改、带召回衰减。
• 会话记事本(notes.md) — 复杂多步任务(≥3 处文件改动 / ≥5 步工具调用)时,agent 在 .mocode/sessions/<sessionId>/notes.md 维护一个工作记事本(落盘抗压缩),可记录中间发现、设计决策、待验证问题和结构化计划。执行计划由专用 plan_update 工具维护——三态步骤机(pending/in_progress/completed,同一时刻至多一个 in_progress),全部完成自动结算为 ## Done:。活跃 plan 在压缩后重注入系统提示、notes.md 一变就重同步进上下文,若连续多步未更新还会有温和提醒。TUI 状态栏实时显示进度 chip:plan: [标题] (3/7) ▸ [当前步]。
• 可中断、可回滚 — Ctrl+C 将中断信号传给模型请求及支持取消的运行中工具；历史恢复到最近已提交工具批次的检查点，而不是无条件丢弃整轮。已经完成的文件写入仍保留，需显式撤销；/rollback 可从轮次快照恢复已追踪文件，逐个选择「保留/撤销」，不依赖 git。
• 输入安全网 — 长 prompt 不再怕误按 Enter:Ctrl+G 弹出 TUI 内「输入面板」(记事本式编辑,Enter=换行、软换行、选区、复制/剪切/粘贴、撤销,Ctrl+S 填回输入框不自动发送);Ctrl+R/Ctrl+P 模糊搜索历史输入(Enter 只回填不发送);长文本误发后撤回窗口自动放宽到 2 秒且任意键可撤回。
• 文件路径边界 — 内置文件读写拒绝越出 SANDBOX_ROOT（默认工作目录）的路径，包括路径穿越和软链出圈。这是文件工具的路径保护，不是针对 shell 命令、MCP server 或桌面输入的操作系统级沙箱；记忆与 skills 可以按设计访问项目外的配置位置。允许高风险工具前应审查权限，详见沙箱策略。
• Computer Use(高危，仅明确 GUI 意图时路由) — 请求确实需要真实鼠标/键盘交互时，router 才可暴露 computer-control，并把每次动作后的截图回灌模型。/cu off（或 MOCODE_COMPUTER_USE_ENABLED=false）是硬否决；/cu on 仅允许按需路由，不会让工具常驻。它会绕过文件沙箱，强烈建议只在 VM / 沙箱 / 专用测试机里使用。每个动作仍走权限门，plan 模式永远屏蔽。Windows 首发，macOS/Linux 待接入。

特性

• 流式输出 + 思考可见 — 回复边生成边显示;模型支持 reasoning 时思考过程实时可见,思考段自动折叠(不占屏)
• 全屏 TUI — 备用屏(alt screen)+ 固定底栏状态行 + 滚动回看(PgUp/PgDn),运行中可打字(typeahead),下一轮自动预填
• 会话持久化 — 每轮自动落盘,--resume / /resume 续接历史会话
• 后台任务 — mocode run --bg "任务" 派 detached 子进程,关终端不死;状态与日志落 .mocode/jobs/,/jobs 可列表/看日志/kill。设 MOCODE_NOTIFY_WEBHOOK 后,任务结束自动推送通知(ntfy/Bark/Telegram/generic)。无人值守任务遇到未授权的 confirm/dangerous 动作时会挂起(状态 paused)并通知你;在另一终端敲 mocode approve <id> 批准(mocode deny 拒绝,或 TUI 内 /jobs approve),任务在同一进程内续跑。用 mocode attach <id> 可实时跟随运行中(或已结束)的任务。长任务在每个工具批次后落 checkpoint;进程挂掉或机器重启后,mocode resume-job <id> 从最后 checkpoint 重放(在途动作会重跑)。MOCODE_JOB_MAX_MS / MOCODE_JOB_MAX_TOKENS 提供硬性时长/token 上限。
• 具名 Bot — mocode bots add 定义岗位 Bot(专属系统提示 + 可选工具白名单 + 沙箱范围),项目/全局两级;--bot <name> 按名运行,可与后台/schedules 组合。
• Arena 竞技场 — arena 工具把同一任务并行跑 N 遍(2-6,各自独立),再由 judge 模型按你给的标准对所有候选打分排序,返回排名和最优方案。适合设计/探索/解题这类“多跑几遍选最好”的场景。
• 持久 Bot 消息协作 — message_bus 工具给具名 bot 提供持久的异步消息存储(send/inbox/ack/history):主管 bot 可把活交给当前没在运行的 bot;worker 之后(如被计划任务唤起)拉 inbox、干活、回复。身份随 --bot 走,每个 bot 只能看到/确认发给自己的消息。
• 计划任务 — mocode schedule add 注册 cron / webhook 触发;本地 detached 守护(schedule start,仅回环)到点或被 POST /trigger/<token> 触发即派后台 job,分钟去重;另有 schedule tick 供系统任务计划调用。
• Headless 一次性执行 — mocode -p "任务" 或管道 echo "任务" | mocode,可选 --json 结构化输出;非交互下 confirm/dangerous 操作默认拒绝(--dangerously-skip-permissions 显式放开;--verbose 追加工具结果摘要、--session-dir <目录>、--worktree git 隔离工作树),会话仍自动落盘可 --resume
• Skills 系统 — 自动扫描 ~/.mocode/skills/ 等目录,description 注入系统提示,模型按需调 use_skill 加载完整指令(渐进式披露:先看简介,任务相关才加载正文)
• 可选桌宠 — 独立悬浮窗(/pet)显示一个小角色,镜像 agent 活动(空闲 / 思考 / 跑工具 / 等人工),独立进程走 WebSocket,/pet quit 完全关闭。挂在终端外,绝不挡终端。
• 斜杠命令 — /exit /clear /cd /context /skills /compact /resume /rollback /jobs /schedules /bots /memory /reflect /init /theme /model /effort /stats /plan /auto /pet,输入时下拉过滤

使用文档

• 菜单式使用指南 — 快速上手、命令速查、模式、会话、项目上下文与排障。
• 项目上下文：AGENTS.md 与 Skills

安装

要求 Node.js ≥ 18。

npm install -g mocode-ai

装完即得 mocode 命令。不想全局装也可免装直跑:npx mocode-ai。

mocode 启动时不查询 registry，也不自动安装更新。需要时显式使用 /upgrade check、/upgrade status 或 /upgrade now 检查、查看状态或升级；源码/tsx 开发模式禁止真正执行安装。实现见升级命令。

从源码运行(开发 / 贡献)

git clone https://github.com/wanxunyang/mocode.git
cd mocode
npm install
npm start

源码经 tsx 直接运行，无需先构建。修改代码后需重启 npm start 生效（tsx 启动时加载模块，不热更新）。请在仓库根目录安装依赖，让 npm 处理 workspaces；完整依赖和开发命令以 package.json 为准，不在此重复维护清单。

技术栈状态与贡献边界

生产主路径是 TypeScript CLI；packages/work-app 处于孵化阶段，packages/pet-app 是可选组件，rust/ 是非关键路径的实验性 TUI，设有晋升或归档期限。参见：

• 技术栈状态与责任人
• 架构决策
• 贡献指南
• 维护与排障手册
• Rust 实验状态

不要导入其他 package 的 src/ 或内部 dist/ 布局；应用通过 package exports 和公开的 mocode-agent-host bin 契约消费能力。

文档与实现同步

修改执行、权限、并发、回滚或升级行为时，应按本页对应的源码入口同步更新 README.md 和 README.zh-CN.md；架构图与当前行为一致后才嵌入。依赖与工具清单分别以 package manifests 和内置工具注册表为准，发布边界以技术栈状态页为准，不把设计提案或旧架构图当作已交付保证。

配置

首次使用运行配置向导,交互填三项(API 地址 / key / 模型名),写入 ~/.mocode/config(全局,任意目录、任意终端生效):

mocode config

也可直接 mocode 进入 REPL 后用 /model 命令配置(交互选后端预设 + 逐项填写,即时生效 + 持久化)。未配置时 REPL 仍能打开,会提示你跑 /model。

也可手写配置文件。mocode 按以下优先级加载(后者覆盖前者,仅回填未设置的环境变量;shell 里 export 的永远最优先):

1. <cwd>/.env — 旧用法兼容,优先级最低(源码仓库内有 .env.example 可参考)
2. ~/.mocode/config — 全局(/model 与 mocode config 写此文件)
3. <cwd>/.mocode/config — 项目级覆盖,优先级最高

必填三项:

LLM_BASE_URL=https://open.bigmodel.cn/api/v3   # 换成你的后端
LLM_API_KEY=your-key-here
LLM_MODEL=glm-4.6                              # 换成你的模型名

常见后端 base_url:

模型必须支持 OpenAI 风格的 function calling,否则工具不会触发。

可选配置

运行

mocode                          # 新会话(在目标项目目录里跑)
mocode --resume                 # 列出已保存会话
mocode --resume <id>            # 续接指定会话
mocode config                   # 改配置

从源码运行使用 npm start。源码和安装版启动时都不会自动检查更新；/upgrade 由用户显式触发，源码/tsx 模式禁止真正执行安装。

进入 REPL 后直接对话。启动即进全屏 TUI,显示横幅(模型 / 后端 / 工作目录 / 工具列表)。回复流式打印,思考段实时可见后折叠。

agent 工作在启动时所在的工作目录——想让它操作某个项目,就 cd 到那个项目再 mocode。

工具

每个真实用户轮都会先经过受约束的 LLM router。公共工具包括 read_file、glob、grep、web_search、web_fetch、plan_update、note_append、ask_human、use_skill；写文件、shell 调试、浏览器调试、桌面观察/控制、记忆、编排和 MCP 作为可组合工具簇按需选择。初始能力不足时，主模型通过 add_tool_groups 请求追加能力，新增 schema 从下一 step 生效。路由失败只继承上一轮工具簇（或仅公共工具），绝不回退到全工具。

以下表格列举部分能力，不是完整工具清单。当前注册及能力声明见内置工具注册表，实际暴露由 ToolPolicy 控制。Codegraph 查询在安装了对应 skill/CLI 时使用，不是独立的内置 codegraph 工具。

前端 / UI 闭环

dev_server + browser 组成「跑起来 → 打开页面 → 看渲染结果」的闭环:

dev_server start  command="npm run dev" readyUrl="http://localhost:5173"
browser    open  →  navigate  →  click / fill  →  screenshot
dev_server stop   id=srv-xxxx

• dev_server 的进程跨工具调用存活(run_command 做不到:它会在超时或本轮中断时树杀)。就绪等待支持 readyUrl(仅回环地址)或 readyPattern(匹配启动日志),日志写在 .mocode/dev-servers/<id>.log,支持按 offset 增量读取。
• browser 的页面会话同样跨调用存活,截图经多模态通道回灌给模型,顺带返回最近的 console、页面报错和失败请求。
• 安全默认:browser 只允许 http/https 的 localhost / 127.0.0.1 / ::1,拒绝 file: 与带凭据的 URL;需要访问远端时显式设 MOCODE_BROWSER_ALLOW_REMOTE=true。dev_server 执行任意命令,风险等级与 run_command 同为 dangerous,执行前需用户确认。
• 两者在 plan 模式下均被禁用;mocode 退出时会树杀后台进程并关闭浏览器。
• 浏览器二进制不随 npm 包分发,首次使用前需 npx playwright install chromium。

前端能力按用途拆分：browser 属于 browser-debug，整桌面截图 screenshot 属于 desktop-observe，而 dev_server 独立成 background-exec 簇（不受 /fe 开关控制，但执行仍需经过权限检查） —— 任何需要跨工具调用存活的进程（dev server、推理/模型服务、watcher、日志尾随）都归它，而不是塞进 run_command。选中 browser-debug 会蕴含激活 background-exec：弱模型只想到要浏览器时，也能拿到「先把服务起起来」的能力（半套能力比多一套能力更糟）。图片读取（read_file 魔数分流）则始终是公共只读能力。任务同时需要结构化网页诊断与真实桌面交互时，router 可再组合 computer-control。/fe off 是硬否决，不是手动 profile 选择器——它不影响 dev_server。

Shell 选择器

run_command 与 dev_server 都接受 shell=cmd|powershell|bash。默认值与旧版一致（Windows 上 cmd.exe，其余平台 bash），现有 prompt / skill 不受影响；想全局换成 POSIX 的用户设 MOCODE_SHELL 即可。在 Windows 上请求 bash 时会自动探测 Git for Windows 的 bash.exe —— 刻意排除 WSL 的 System32\bash.exe：它进的是 Linux 发行版，路径（/mnt/f/…）、工具链与安全策略都与 Windows 原生预期不符。另外，非交互 cmd.exe 跑不了 timeout /t（直接报错），需要等待时用 shell=powershell + Start-Sleep，或 shell=bash + sleep。

自动重试（retryable 契约）

工具返回的 retryable 此前全项目零消费者 —— 工具诚实标了「这是瞬时失败」，却没人据此行动，模型只能再发一轮 tool call 自救（白烧一个 LLM 往返，且常常忘记重试）。现在 runtime 对显式声明 idempotent 的工具在退避后自动重发（400ms / 1200ms，最多两次）：

• 只有无副作用的网络只读工具（web_fetch、web_search）声明了该能力；写文件 / 起进程类工具一个都没有，也不会自动重试 —— 重试语义由工具自己决定（如 edit_file 的 expected_hash 冲突）。
• 只重试 status=error 且 retryable=true 的结果；denied / aborted / success 都是终态。
• TIMEOUT 不自动重试：一次超时已经烧掉整个超时窗口（web_fetch 是 30s），再试两次最坏会让单次工具调用变成 90s，用户看到的就是 spinner 长时间冻住。retryable 标记仍保留，模型可自行判断。
• 退避等待期间用户 Ctrl+C 立即放弃，不空耗窗口；重试用尽仍失败会把尝试次数写进 output，让模型知道「runtime 已经试过了，别再无脑重发」。

6 个 memory_* 工具拆成 memory-read 与 memory-write。只有 router 选择对应簇时才出现；MEMORY_ENABLED=false 会硬禁用两簇，true 还会把紧凑 Memory Index 注入 prompt。/memory_switch 同时管理这个兼容 gate 与 Index 状态。

斜杠命令

输入 / 触发下拉菜单,继续打字过滤;Esc 取消。

快速验证(配好 key 后)

> 你好,你是谁                       # 验证 LLM 连通
> 读一下 sample.txt                 # 触发 read_file
> 把 sample.txt 里的 foo 改成 bar    # 触发 read_file + edit_file
> 列出当前目录所有 .txt 文件         # 触发 glob
> 搜一下代码里出现 runAgent 的地方   # 触发 grep
> 跑一下 node -e "console.log(1+1)"  # 触发 run_command
> 搜一下 TypeScript 5.5 有什么新特性  # 触发 web_search

每步终端会打印 ● 工具名 + 参数摘要 与 ↳ 结果预览,agent 在循环里自己决定下一步;回复流式打印,边生成边显示。

Skills

mocode 自动扫描以下目录的 skill(每个 skill 是 <name>/SKILL.md,带 frontmatter):

• ~/.claude/skills/
• ~/.mocode/skills/
• <cwd>/.mocode/skills/

skill 的 description 注入系统提示(渐进式披露第①层),模型只在任务相关时调 use_skill 加载完整正文(第②层)。用 /skills 查看已发现的 skill。

工作纪律

system prompt 提供轻量建议而不是框架硬门：只检查支持下一步决策的内容，做最小完整改动，避免重复读取，并诚实说明不确定性。agent 自主决定是否需要验证以及验证范围；框架不会因为未验证阻止完成或追加模型轮次。

项目记忆(AGENTS.md)

mocode 的双层记忆模型,跟 Skills 是两件事:

• Tier-1 — AGENTS.md(每轮自动加载,瘦身注入): Markdown 项目记忆,每轮拼进 system prompt。发现路径:~/.mocode/AGENTS.md → 从 cwd 往上逐级 AGENTS.md(远→近拼接,近的覆盖更突出);超长截断并标注原始文件。注入按章节过滤:「目录结构」「扩展点」两节不进 prompt,压成一行指针(需要时 read_file AGENTS.md 按需取),常驻面只留 项目/命令/约定 等高价值节。运行 /init 生成或刷新(整体重写、≤4000 字且不超过旧文件、按章节预算分配、装不下的高价值事实进 .mocode/agents-draft.md 草稿、产出新旧字数对账),纯 Markdown,可手写,无 schema。agent 工作中发现的「下次要记住的稳定事实」可先追加到 .mocode/agents-draft.md 草稿,由 /init 合并进 AGENTS.md 并清空。
• Tier-2 — memory_* 工具库(agent 主导,按需路由): 离散带标签条目(decision / fact / pitfall / reference / feedback),按召回计数衰减(30 天 → archived,90 天 → 硬删 GC)。agent 用 memory-read 召回，用 memory-write 处理明确的持久化意图；保存前先搜索，已有条目优先更新而非重复创建。MEMORY_ENABLED=false 会硬禁用两簇，true 还会注入紧凑 Memory Index；可在 REPL 内用 /memory_switch 管理。

类型检查

npm run typecheck   # protocol/runtime + 根项目 + tests + evals

可后续扩展

MCP 工具集成已经支持，配置见 MCP 指南。更细粒度的能力协调、可选的每 worker 独立 worktree 是后续扩展方向，不是当前共享工作区子 agent 已具备的保证。现有工具以内置工具注册表为准，生产、可选、孵化和实验技术栈的区别见技术栈状态。