Codachi 是一个伪装成 tamagotchi（电子宠物）的生产力副驾驶，它生活在 Claude Code 的状态栏中。
【用途】 它为 Claude Code 用户提供一个常驻状态栏的虚拟宠物，既增加陪伴感，也承担上下文监控与生产力追踪的辅助功能。
【主要能力】
- Context ETA：预测上下文剩余时间，例如提示“~15m left”，告诉用户何时该执行 /compact，而不仅仅是显示上下文有多满。官方称其为唯一能预测此信息的 statusline。
- 事件感知宠物：通过 hooks 观察 Claude 的工作，并以 900+ 条上下文相关消息、覆盖 40+ 事件类别做出反应。消息支持文件感知（显示正在编辑的实际文件名）、时间感知（早晨/夜晚/周末）和关系感知（陌生人与挚友使用不同消息）。
- codachi stats：本地、零遥测的生产力仪表盘，展示会话数、运行时长、关系等级进度、最近 24 小时的测试/提交/编辑次数。
- 插件 API：将 .mjs 文件放入 ~/.config/codachi/plugins/ 即可添加自定义配色和消息，无需 fork。
- i18n：内置简体中文，缺失键回退到英文；可通过 CODACHI_LOCALE 自带区域设置。
- 终端感知：自动检测 truecolor / 256 色 / 16 色 / 单色并优雅降级；遵循 NO_COLOR。
- 零开销：无 API 调用、不消耗 token，本地 JSON + 磁盘存储，渲染 p95 约 0.1ms（由 npm run bench 验证）。
【使用方式】 一行命令即可安装并接入 ~/.claude/settings.json 的 statusline 和 PostToolExecution 钩子。重启 Claude Code 后宠物即会孵化。也支持全局安装：npm install -g codachi && codachi init。安装后还有若干实用命令（资料未逐一列出具体命令名）。 可通过交互式向导配置，或直接编辑 ~/.config/codachi/config.json。状态栏支持的小部件（第一行）：model、context、velocity、rateLimit5h、rateLimit7d，可在 widgets 数组中重排或移除。 插件消息键包括：BUSY_MESSAGES、DANGER_MESSAGES、USAGE_HIGH_MESSAGES、VELOCITY_FAST、VELOCITY_SLOW、COMPACT_SUGGEST、IDLE_MESSAGES（按动物）、SIZE_MESSAGES（按体型）、WELCOME_MESSAGES（按等级）、TIER_UPGRADE（按等级）、RARE_EVENTS、EVENT_MESSAGES（按类别）、FILE_TYPE_MESSAGES（按语言）、以及 GIT_CLEAN_MESSAGES / GIT_BUSY_MESSAGES / GIT_AHEAD_MESSAGES / GIT_BEHIND_MESSAGES / GIT_STASH_MESSAGES / GIT_WIP_MESSAGES。用户覆盖文件放在 ~/.config/codachi/locales/<locale>.json，同键模式，允许部分文件（缺失键回退英文）。
【宠物的成长与反应】 宠物会随上下文使用量增大而变大。每个会话随机分配一个物种与配色（也可在配置中指定）。5 个物种、5 种情绪、10 套配色（Coral Flame、Electric Blue、Neon Mint、Purple Haze、Hot Pink、Golden Sun、Ice Violet、Cherry Blossom、Cyan Surge、Tangerine）。宠物的情绪反应覆盖多种事件类别：测试（通过/失败）、构建（通过/失败）、安装包、Git（commit、push、pull、merge、rebase、stash、checkout）、Lint/格式化、服务器启动、Docker/K8s、网络/HTTP、危险命令、搜索/grep、按类型编辑文件（测试、文档、样式、配置、代码）、新建文件、快速编辑、代码探索、从错误恢复、挣扎模式（3+ 次失败）、会话里程碑、等级升级、智能 /compact 建议等。 宠物会跨会话记住你并提升关系等级；等级升级会触发一次性庆祝。当上下文超过 70% 且消耗速度快时，宠物会温和地提示一次 /compact，不重复唠叨。
【适用场景】 适合使用 Claude Code 并希望实时掌握上下文消耗节奏、及时 compact 的开发者；也适合喜欢在编码环境中获得陪伴感、事件反馈与轻量生产力统计的用户。
【限制】 调试日志位于 ~/.claude/plugins/codachi/codachi.log（256KB 自动轮转）。数据存储在 ~/.claude/plugins/codachi/。其他更详细的限制信息资料未提供。价格、收费方式等资料暂未提供。
