Baboon Code
fiofio66/babooncode
Assistente de coding com IA no terminal, estilo Claude Code
Ver no GitHubAgent de programação em IA que roda no terminal, inspirado na arquitetura do Claude Code. Lê arquivos, escreve código, executa comandos e gerencia tarefas de desenvolvimento com interface TUI interativa e suporte a múltiplos provedores LLM.
Instalação
npx convez-ai fiofio66/babooncode1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Refatoração e manutenção de código assistida por IA
- Automação de tarefas de desenvolvimento e scripts
- Busca e análise de código em projetos grandes
- Planejamento e execução de mudanças estruturadas
Veredito

Projeto maduro com arquitetura bem pensada (Agent loop, sistema de permissões, worktree isolation). Excelente para desenvolvimento local com controle fino sobre execução; requer Python 3.11+ e configuração de API keys, indicado para desenvolvedores que querem alternativa terminal ao Claude Code.
README
A tradução para o português deste README ainda está na fila.
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 — 随便用,出问题别找我。