Coding Agent Pet
golitter/coding-agent-pet
Mascote virtual que reage aos eventos de seu editor de código
Ver no GitHubUm agente de desktop em forma de mascote virtual que interage com eventos do ciclo de vida de assistentes de IA (Claude Code, Codex, OpenCode). Construído com Tauri, exibe animações de sprite e diálogos contextuais conforme o assistente executa, compila ou revisa código.
Instalação
npx convez-ai golitter/coding-agent-pet1 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
- Visualizar feedback visual durante sessões de codificação com IA
- Personalizar experiência de desenvolvimento com mascote interativo
- Integrar eventos de hooks do Claude Code, Codex e OpenCode
Veredito

Projeto criativo que humaniza a interação com assistentes de código através de um mascote pixel art responsivo. Ideal para desenvolvedores que buscam uma experiência de programação mais leve e visual, com implementação sólida em Tauri e boa documentação arquitetural.
README
A tradução para o português deste README ainda está na fila.
coding-agent-pet
一个基于 Claude Code、Codex、OpenCode Hooks 的桌面虚拟宠物项目。 当前默认角色是像素风南琴梨(Kotori Minami),会随着 AI 编程助手的生命周期事件切换动画与气泡台词。
基于 Tauri v2(Rust + HTML/CSS/JS)构建。
↑ 完整精灵图:9 个状态行 × 8 列网格,共 57 帧动画。规格详见 desktop/docs/reference/spritesheet.md。
快速开始
cd desktop/cross-platform
cp config.example.json config.json # 按需修改
bash setup.sh # 正式推荐:一键完成依赖 → 配置 → hooks → 编译 → 启动
setup.sh 会自动安装 Claude Code / Codex / OpenCode 三套 hooks 集成;重复执行不会重复追加。
其中 Codex 会自动写入 hook,并尽量启用已有 trust 记录的条目,但首次使用通常仍需要在 /hooks 里手动 Trust/Enable 一次。
日常首次安装、换机、或者完整更新时,推荐始终使用 bash setup.sh。
build-and-run.sh 更适合已经完成初始化后的开发态增量重启。
交互
| 操作 | 效果 |
|---|---|
| 悬停 | 跳跃 🎉 |
| 三连击(800ms 内) | 清空所有会话 🧹 |
| 拖动 | 移动位置(方向奔跑动画) |
| 右键 | 菜单:关闭宠物 |
架构
Claude Code / Codex → hook 脚本 (pet-hook.sh) ──┐
├→ session 文件 + Unix Socket → Tauri 渲染器
OpenCode → TS 插件 (opencode-plugin.ts)┘ ├── Rust: 多会话聚合 + 双通道监听
└── JS: 精灵动画 + 对话气泡
状态优先级:waiting > running > running-left/right > review > jumping > waving > idle > failed
在 Codex 中生成宠物素材
通过 Codex Skill 一键生成像素资料包,详见 教程。
文档
完整索引(架构 / Hook 协议 / 源码 / 配置 / 精灵图规格 / Bugfix)详见 docs/reference/details.md。
目录结构
.
├── assets/kotori-minami/ # 资料包(frames/ 运行时 + imagegen/ 生成工件)
├── desktop/
│ ├── cross-platform/ # Tauri 主实现(src/ + src-tauri/ + hooks/)
│ │ └── hooks/ # pet-hook.sh (Claude/Codex) + opencode-plugin.ts (OpenCode)
│ └── docs/ # 跨平台 / Hook / 精灵图 / Bugfix
└── docs/ # 顶层文档(教程 + reference/details.md)
要求
- macOS 13+ · Rust + Cargo · Node.js + npm · Python 3
License
MIT