Baboon Code 🐵

一个跑在终端里的 AI 编程助手，长着一张狒狒脸。

这是什么

本质上就是个终端里的 AI coding agent（类ClaudeCode）——你跟它聊天，它能读文件、写代码、搜项目、跑命令。无聊的时候还能看它一边"思考"一边转圈。

名字叫 Baboon Code 纯粹因为本人姓氏（狒狒），没别的意思。

安装

# 克隆仓库
git clone https://github.com/fiofio66/babooncode.git
cd babooncode

# 装依赖
pip install -e .

需要 Python 3.11+

配置

在项目根目录创建 .babooncode/config.yaml：

# 至少配一个 LLM provider
providers:
  - name: deepseek
    api_key: your-api-key
    model: deepseek-chat
    base_url: https://api.deepseek.com
    protocol: openai  # 或者 anthropic

# 权限模式: default | accept-edits | plan | bypass
permission_mode: default

支持的 provider 协议：OpenAI 兼容接口、Anthropic 原生协议。

更多配置项见 .babooncode/config.yaml。

使用

cd 你的项目目录
python -m babooncode
# 或者装了之后直接
babooncode

进入 TUI 后跟它打字聊天就行。内置命令（以 / 开头）：

命令	说明
/help	查看所有命令
/clear	清空对话
/compact	压缩对话上下文（省 token）
/session new	开启新会话
/session list	列出历史会话
/session resume <id>	恢复历史会话
/memory add <内容>	手动添加记忆
/memory search <关键词>	搜索记忆
/permission	查看/切换权限模式
/plan	进入计划模式（只出方案不执行）
/trace	查看子 Agent 调用链
/tasks	查看后台任务状态
/worktree create	创建工作空间分支
/mcp	管理 MCP 服务器
/skill list	列出可用技能

快捷操作

• Shift+Tab — 切换权限模式（default → accept-edits → plan → YOLO）
• Ctrl+O — 折叠/展开工具调用详情
• Esc — 取消当前操作
• @文件名 — 快速引用文件内容到对话中

命令行模式

# 非交互式执行（适合脚本/CI）
babooncode -p "把 src/ 下所有 TODO 注释列出来"

功能亮点

工具系统

内置了一系列工具，Agent 自己决定什么时候用哪个：

• 文件读写、编辑、搜索（Glob / Grep）
• Shell 命令执行（受权限控制）
• MCP 工具接入（可扩展）
• 自定义 Skill 加载

子 Agent

可以 fork 出子 Agent 跑后台任务——比如一边修 bug 一边让子 Agent 帮你查文档。任务完成后会自动通知主 Agent。

记忆系统

Agent 会记住你告诉它的事情。手动添加记忆或者让它自己从对话中提取。下次开新会话还能回溯。

工作空间隔离 (Worktree)

用 git worktree 机制创建隔离的工作副本，Agent 在里面随便折腾，不会弄脏你的主工作区。

计划模式

不确定 Agent 会干什么的时候，先切到 plan 模式——它会列出执行计划等你审，确认没问题了再真正执行。

项目结构

babooncode/
├── app.py              # Textual TUI 主界面
├── agent.py            # Agent 核心循环
├── client.py           # LLM 客户端（OpenAI / Anthropic）
├── config.py           # 配置加载
├── conversation.py     # 对话管理
├── tools/              # 内置工具集
├── agents/             # 子 Agent 系统
├── commands/           # 斜杠命令系统
├── memory/             # 记忆/会话持久化
├── permissions/        # 权限检查 & 沙箱
├── hooks/              # 事件钩子系统
├── mcp/                # MCP 协议集成
├── worktree/           # Git worktree 管理
├── teams/              # Agent 团队协作
├── skills/             # 可加载技能模块
└── styles.tcss         # TUI 样式表

TODO

有些东西还没做完，随缘补：

• 更好的 streaming 渲染（现在 token 多了会卡）
• 图片/截图分析能力
• 更智能的上下文压缩策略
• Web UI 模式（Textual-web 或者自己写一个）
• 更多 provider 支持（Ollama 本地模型）
• 测试覆盖率提上去（现在覆盖率感人）
• Agent 对话分支 (tree conversation)
• 插件市场

License

MIT — 随便用，出问题别找我。