MiniCode
面向本地开发的轻量级终端编程助手，提供工具调用与审阅后写入流程。
这个 Agent 能做什么，适合哪些场景？
MiniCode 是面向本地开发工作流的轻量级终端编程助手，主仓库采用 TypeScript。它以全屏终端 UI 承载输入、转录记录、斜杠菜单、审批流程与会话操作。一次请求可进入“模型→工具→模型”的循环，检查工作区、执行所需工具，并在同一终端会话中返回最终回复。项目支持本地 Skills 与 MCP，并提供会话持久化、上下文压缩和大工具结果落盘预览等机制。它的运行边界是本地终端和项目文件；安装器将模型及 Anthropic 连接配置写入用户配置目录。
MiniCode 接收终端中的用户请求，检查当前工作区，并调用内置的文件、搜索、编辑、命令执行、网页抓取/搜索及澄清提示工具。写入文件前会经过审阅，并执行路径与命令权限检查；过大的工具结果会写入磁盘，只在上下文中保留简短预览和文件路径。通过 /init 可创建当前项目的 .mini-code/ 与 MINI.md，通过 /tools、/skills、/mcp、/status、/memory 查看运行状态；/resume、/compact 处理会话恢复和上下文压缩。流程结束后，它在同一个终端会话中输出最终回复。
- 希望研究 Claude Code 风格工具循环与终端交互架构的开发者，可用它阅读和修改较小的 TypeScript 实现。
- 在本地项目中需要由终端助手检查文件、搜索内容、执行命令并在写入前进行审阅的个人开发者。
- 需要为特定项目保存会话，并使用 /resume、重命名、分叉或 /compact 管理长对话的开发者。
- 想通过 SKILL.md 为本地项目发现技能，或通过 stdio、远程 HTTP 接入 MCP 工具、资源和提示词的工具构建者。
- 需要在不连接模型时演示终端流程的学习者，可使用 MINI_CODE_MODEL_MODE=mock 运行开发模式。
这个 Agent 有哪些优点和局限？
- 以紧凑的 TypeScript 实现呈现“模型→工具→模型”循环，适合学习、实验和二次定制。
- 全屏 TUI 已包含输入历史、转录滚动、斜杠菜单和审批流程，而不是只提供单条命令入口。
- 对长会话提供持久化、恢复、重命名、分叉、自动压缩、上下文折叠与 snip compact。
- 内置文件、搜索、编辑、命令、网页和澄清工具，并支持本地 Skills 与 MCP 扩展。
- 安装流程要求提供模型名称、ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN；提供的证据未说明其他模型提供商路径。
- 需要本地终端、文件系统和 npm；源码未给出 Node.js 版本要求。
- 其定位明确偏向学习、实验和自定义工具，提供的材料没有生产部署、可靠性或性能保证。
- Rust、Python、Go 与 Java 版本以独立链接仓库形式列出，不能据此视为本仓库可直接切换的运行时。
如何安装或部署这个 Agent？
在仓库目录执行：
cd mini-code
npm install
npm run install-local
安装器会要求填写模型名称、ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，并将配置写入 ~/.mini-code/settings.json 与 ~/.mini-code/mcp.json。可用 MINI_CODE_HOME 修改配置目录、用 MINI_CODE_BIN_DIR 修改启动器目录。
如何使用这个 Agent？
安装后运行 minicode。开发模式运行 npm run dev；离线演示可运行 MINI_CODE_MODEL_MODE=mock npm run dev。进入后可先使用 /help，随后按需使用 /tools、/skills、/mcp 和 /status；/init 会为当前项目创建 .mini-code/ 和 MINI.md。
这个 Agent 与同类方案有什么区别？
项目将自身描述为采用 Claude Code 类似的工作流与架构思路，但实现规模更小，目标是让控制流、工具模型和 TUI 行为更易理解和扩展。