cc-mini

用于 AI Agent 的超轻量级架构脚手架

Agentic（代理式）  ·  易于扩展  ·  源自 Claude Code

整个核心代码仅 ~1000 行 Python

---

新功能：Buddy — 带有自定义精灵的 AI 伙伴

你的编程伙伴住在终端里。输入 /buddy 即可孵化它。支持自定义 ASCII 物种 —— 快把你自己的皮卡丘带进来吧！

查看完整的 Buddy 文档 →

---

功能特性

核心功能

• 交互式 REPL：支持流式输出、命令历史记录、斜杠命令自动补全
• Agentic 工具循环：Claude 可以自主调用工具，直到任务完成
• 9 个内置工具：Read, Edit, Write, Glob, Grep, Bash, AskUser, EnterPlanMode, ExitPlanMode
• 计划模式 (Plan mode)：在实施前并行运行子 Agent 来探索代码库，并具备权限隔离功能
• 权限系统：具备模式感知能力（默认/计划），读取操作自动通过，写入/Bash 操作需要手动确认
• 会话持久化：自动保存对话，使用 /resume 即可稍后继续
• 上下文压缩：接近 Token 上限时自动压缩上下文
• Anthropic + OpenAI 兼容：可与任何兼容的 API 端点配合使用

高级功能（来自尚未发布的 Claude Code 特性）

特性	描述	文档
Coordinator 模式	用于并行研究和实施的后台工作进程	文档 →
Buddy	具备个性、属性、心情和气泡对话框的电子宠物 (Tamagotchi)	文档 →
KAIROS Memory	具备自动巩固功能的跨会话记忆系统	文档 →
Skills	一键式工作流：/review, /commit, /test, /simplify	文档 →
Sandbox	为 Bash 命令提供 Bubblewrap 隔离环境	文档 →

查看 docs/examples/citorigin 获取特定项目的自定义技能示例。

---

快速上手

环境要求

• Python 3.10+ (推荐 3.11+)
• Anthropic 或任何兼容 OpenAI 的 API Key

安装

# 一键安装（推荐）
curl -fsSL https://raw.githubusercontent.com/e10nMa2k/cc-mini/main/install.sh | bash

# 或手动安装
git clone https://github.com/e10nMa2k/cc-mini.git
cd cc-mini
pip install -e ".[dev]"

设置 API Key

# Anthropic
export ANTHROPIC_API_KEY=sk-ant-...

# 或使用兼容 OpenAI 的 API
export CC_MINI_PROVIDER=openai # 协议类型，非供应商名称
# Azure AI Foundry 和其他兼容 OpenAI 的网关仍需使用 "openai"
# (不要将 provider 设置为 "foundry", "bedrock" 等)
export OPENAI_API_KEY=sk-...
export OPENAI_BASE_URL=https://your-gateway.example.com/v1
export CC_MINI_MODEL=gpt-... # 可选，默认为 "gpt-5.1-codex"

运行

cc-mini                              # 交互式 REPL
cc-mini "what tests exist?"          # 单次指令
cc-mini -p "summarize this codebase" # 打印并退出
cc-mini --auto-approve               # 跳过权限确认
cc-mini --resume 1                   # 恢复上一次会话
cc-mini --coordinator                # 协调者模式

首次会话演示

cc-mini

> list all python files in this project
↳ Glob(**/*.py) ✓
Found 12 Python files...

> read engine.py and explain the tool loop
↳ Read(src/core/engine.py) ✓
The submit() method implements an agentic loop...

> /buddy
Hatching your companion...
✨ SHINY LEGENDARY DUCK
Glitch Quack hatched! ★★★★★

> /buddy mood
Glitch Quack's mood:
  Happy      ████████████████░░░░  65 (high)
  Bored      ██████████░░░░░░░░░░  50 (neutral)

> /review
Running skill: /review…
↳ Bash(git diff) … ✓ done
## Code Review: no issues found ✓

查看完整的配置文档 →

---

工具列表

工具	描述	权限
Read	读取文件内容	自动通过
Glob	按模式查找文件	自动通过
Grep	搜索文件内容	自动通过
Edit	编辑文件 (字符串替换)	需要确认
Write	写入/创建文件	需要确认
Bash	运行 Shell 命令	需要确认
AskUser	向用户提问	自动通过
EnterPlanMode	进入计划模式	自动通过
ExitPlanMode	退出计划模式	自动通过

Coordinator 模式增加了：Agent（生成工作进程）、SendMessage（继续工作进程）、TaskStop（停止工作进程）。计划模式也使用 Agent 来启动并行的只读探索/计划子 Agent。详见 Coordinator 文档。

---

数据路径

数据	路径
安装 (源代码)	~/.cc-mini/
会话记录	~/.config/cc-mini/sessions/
记忆 (KAIROS)	~/.config/cc-mini/memory/
计划任务	~/.config/cc-mini/plans/
REPL 历史记录	~/.config/cc-mini/history
伙伴数据	~/.config/cc-mini/companion