mini claude code impl for learning agent
极简教学版 AI 编程助手(TUI),参考 Claude Code 的交互形态,用更少的代码把核心机制讲清楚:工具调用、事件驱动 UI、子代理与 MCP。
v0.3.x 起对外只保证 TUI 行为 稳定,内部模块/API 允许 breaking change。
read_file / write_file / edit_file)glob_files / grep_search)bash / bash_output / kill_shell)todo_write)task(wait=True):默认等待子代理完成并返回结果,主 Agent 可以直接整合继续推理task(wait=False):后台启动多个子任务wait_subagents():等待所有后台子任务结束并汇总输出MINICC_MCP_STRICT=1 强制启动失败(适合 CI/严格环境)agent.run_stream_events() 的 ToolCall/ToolResult 事件(running/completed/failed)Ctrl+J 换行;Enter 发送@ 引用文件:输入 @ + 片段弹出候选,↑/↓ 选择,Enter/Tab 插入路径# uv
uv pip install minicc
# pip
pip install miniccexport ANTHROPIC_API_KEY="sk-ant-xxx"
# 或
export OPENAI_API_KEY="sk-xxx"minicc
# 或
python -m minicc也可以直接运行(无需手动安装):
uvx minicc~/.minicc/config.json{
"provider": "anthropic",
"model": "claude-sonnet-4-20250514",
"api_key": null,
"base_url": null,
"prompt_cache": {
"instructions": false,
"messages": false,
"tool_definitions": false
}
}配置文件位置优先级:
.minicc/mcp.json~/.minicc/mcp.json启用 MCP 需要安装可选依赖:
pip install "minicc[mcp]"
# 或
uv pip install "minicc[mcp]"严格模式(配置错误/缺依赖时直接失败):
export MINICC_MCP_STRICT=1~/.minicc/AGENTS.md:自定义系统提示词(建议写清“可选方案/等待子代理/何时 ask_user”)。
| 快捷键 | 功能 |
|---|---|
| Enter | 发送消息 |
| Ctrl+J | 输入框换行 |
| Ctrl+C | 退出 |
| Ctrl+L | 清屏 |
| Esc | 取消/关闭候选 |
minicc/
├── cli.py # 入口(仅启动 TUI)
├── core/ # 运行时/模型/事件总线/MCP 预加载
├── tools/ # 工具实现(按职责拆分)
└── tui/ # Textual TUI(消费 stream events + event_bus)git clone https://github.com/TokenRollAI/minicc.git
cd minicc
uv sync
uv run miniccTextual 开发模式:
uv run textual run --dev minicc.tui.app:MiniCCApp
textual console运行测试:
.venv/bin/pytest -q/help、/clear、/model、/tasks、/mcp 等llmdoc/index.md:文档索引llmdoc/guides/usage.md:使用指南llmdoc/guides/testing.md:测试指南MIT
No open issues yet, or sync has not completed.