TokenRollAI/minicc

197 stars · Last commit 2025-12-18

mini claude code impl for learning agent

README preview

# MiniCC

极简教学版 AI 编程助手(TUI),参考 Claude Code 的交互形态,用更少的代码把核心机制讲清楚:工具调用、事件驱动 UI、子代理与 MCP。

> v0.3.x 起对外只保证 **TUI 行为** 稳定,内部模块/API 允许 breaking change。

## 已实现能力(当前)

### 基础 Coding 能力

- 文件相关:读/写/精确替换编辑(`read_file` / `write_file` / `edit_file`)
- 代码检索:glob + 内容搜索(`glob_files` / `grep_search`)
- Shell:前台执行与后台任务(`bash` / `bash_output` / `kill_shell`)
- 任务列表:模型可写 todo,TUI 实时展示(`todo_write`)

### 子代理(SubAgent)

- `task(wait=True)`:默认等待子代理完成并返回结果,主 Agent 可以直接整合继续推理
- `task(wait=False)`:后台启动多个子任务
- `wait_subagents()`:等待所有后台子任务结束并汇总输出

View full repository on GitHub →