LiuMengxuan04/MiniCode

MiniCode – 一个轻量级的终端优先编程助手

它是什么 – MiniCode 是一个开源的、基于终端的 AI 编程助手，模仿 Claude Code 代理模式，但代码库非常小。它在本地运行，与 LLM（Anthropic 的 Claude 或任何通过 Sidrune AI 统一 API 暴露的模型）对话，并可以调用一组内置工具（文件编辑、搜索、Shell 命令、网页抓取等）来执行用户的请求。

为什么重要 – 大多数 AI 驱动的编程助手都是大型 Web 服务或重量级桌面应用。MiniCode 刻意保持小巧（几千行 TypeScript），以便开发人员可以阅读、修改和扩展整个代理循环。因此，它适用于：

• 学习 LLM 工具调用代理是如何连接起来的，
• 在没有云平台的情况下构建自定义的、项目特定的助手，
• 在终端 UI 中试验多步骤工具工作流、目标和规划。

核心能力

• 模型 ↔ 工具 ↔ 模型循环 – 单轮可以调用多个工具，将结果反馈给 LLM，并获得最终答案。
• 子代理 – 最多三个只读工作进程并行运行；根代理拥有所有文件更改。
• 内存中的计划与目标 – /plan 显示代理更新的待办事项列表；/goal 创建一个跨轮次持续存在的持久目标。
• 循环功能 – 按定时间隔重复提示，共享同一计划。
• 全屏 TUI – 转录滚动、斜杠命令菜单、任何文件写入前的批准提示。
• 会话持久化 – 每个项目都有自己的 .mini-code/ 文件夹；会话可以恢复、重命名或分叉。
• 上下文管理 – 使用优先统计、自动压缩和裁剪过大的工具结果。
• 可扩展工具集 – 文件操作、grep 风格搜索、Shell 执行、网页抓取、澄清提示，以及通过 SKILL.md 定义的用户自定义技能。

安装与快速开始

# 克隆并安装
git clone https://github.com/LiuMengxuan04/MiniCode.git
cd MiniCode
npm install
npm run install-local   # 提示输入模型名称和 Anthropic 凭据

# 启动助手
minicode

模拟模式（MINI_CODE_MODEL_MODE=mock）允许你在没有 API 密钥的情况下试用 UI。

典型工作流

1. 输入请求 – 例如“为 parseJson 添加单元测试”。
2. MiniCode 检查工作区，决定需要哪些工具，并调用它们（搜索文件、运行测试运行器等）。
3. LLM 接收工具输出，完善计划，并提出文件更改。
4. 你在 TUI 中审查差异；MiniCode 在写入前请求确认。
5. 最终响应（摘要、后续步骤等）在同一终端会话中显示。

多语言生态系统 – 该仓库托管 TypeScript 参考实现。Rust、Python、Go 和 Java 中也有等效版本，表明该架构与语言无关。

谁在背后 – 创始人 Liu Mengxuan（TypeScript 核心）、联合发起人 GateJustice（长会话上下文系统），以及几位贡献者负责子代理、内存层和语言移植。

了解更多 –

• 使用指南（USAGE.md）– 完整的命令参考和配置示例。
• 架构概述（ARCHITECTURE.md）– 解释代理循环、内存层和工具模型。
• 演示页面 – 打开 docs/index.html 或 GitHub-Pages 站点进行可视化演练。

理想用户

• 想要仅终端 AI 助手的开发人员。
• 研究 LLM 驱动的工具调用模式的研究人员或爱好者。
• 需要可定制、自托管的编程助手而无需云平台开销的团队。

---

MiniCode 是一个真正的、轻量级的 AI 代理项目，专注于编程辅助，而不是通用的教程列表或琐碎的演示。