mortis-cube

Mo Code — Development skill for Claude Code

Development community

mo-code 是 mortis 从零实现 Claude Code 核心功能的实验项目，目标是实现一个可运行、可解释，并重点研究安全边界的终端 Coding Agent.

How to install Mo Code

This entry records only its repository, not the path inside it, so there is no exact command to give. Open mortis-cube/mo-code and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Mo Code does

mo-code 是 mortis 从零实现 Claude Code 核心功能的实验项目，目标是实现一个可运行、可解释，并重点研究安全边界的终端 Coding Agent。

Alternatives in Development

OpenAI Codex CLI — (Rust implementation) 67.8k ★
Chrome Devtools MCP — Chrome DevTools for coding agents 29504 108 1 31.7k ★
Vibe Kanban — Get 10X more out of Claude Code, Gemini CLI, Codex, Amp and other coding agents 23.5k ★

README

mo-code

**从零实现一个可运行、可解释，并重点研究安全边界的终端 Coding Agent。**

[![CI](https://github.com/wenxuezj-design/mo-code/actions/workflows/ci.yml/badge.svg?branch=dev)](https://github.com/wenxuezj-design/mo-code/actions/workflows/ci.yml?query=branch%3Adev) [![Release](https://img.shields.io/github/v/tag/wenxuezj-design/mo-code?sort=semver&label=release)](https://github.com/wenxuezj-design/mo-code/tags) [![Tests](https://img.shields.io/badge/tests-285%20passing-brightgreen)](test) [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22-339933?logo=nodedotjs&logoColor=white)](https://nodejs.org/) [![TypeScript](https://img.shields.io/badge/TypeScript-7-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![pnpm](https://img.shields.io/badge/pnpm-10-F69220?logo=pnpm&logoColor=white)](https://pnpm.io/) [![License](https://img.shields.io/github/license/wenxuezj-design/mo-code)](LICENSE) [![Last commit](https://img.shields.io/github/last-commit/wenxuezj-design/mo-code/dev)](https://github.com/wenxuezj-design/mo-code/commits/dev)

[快速开始](#快速开始) · [核心能力](#核心能力) · [架构](#系统架构) · [权限与安全](#权限与安全) · [实现笔记](#实现路线)

项目定位

mo-code 是一个用于学习和验证现代 Coding Agent 核心机制的实验项目。它不是对大模型 API 的简单封装，而是完整实现了从上下文构建、流式推理、工具调用和结果反馈，到会话恢复、权限裁决、路径边界与项目信任的执行闭环。

项目主要探索两个问题：

大模型如何通过文件、Shell 和网络工具真正参与软件开发？
当 Agent 获得本机操作能力后，如何建立可解释、可配置、可验证的安全边界？

相比直接使用成熟 Agent 框架，mo-code 刻意保留关键机制的实现细节，适合作为 Coding Agent 的学习样本、功能实验台和安全策略原型。

核心能力

Agent 执行闭环

基于 Anthropic Messages API 的多轮 Agent Loop
动态组装 System Prompt、项目指令、Git 状态和运行环境
模型调用工具后自动回传 tool_result 并继续推理
支持 Extended Thinking、Prompt Caching 及使用量统计
支持兼容 Anthropic API 协议的模型服务

流式与并发

模型文本增量输出，并通过平滑写入降低终端抖动
流式解析工具调用，参数完整后即可提前启动安全工具
并发安全工具批量执行，副作用工具形成顺序屏障
使用同一个 AbortSignal 中断模型流、工具执行和权限等待
中断后补齐合法工具结果，避免保存不可恢复的消息历史

工具系统

工具	作用	可靠性设计
`read_file`	读取文件并附带行号	记录文件状态，为后续安全编辑建立基线
`write_file`	创建或覆盖文件	已有文件必须先读取，检查并发修改
`edit_file`	精确替换局部内容	唯