codachi

codachi

**A productivity copilot disguised as a tamagotchi, living in your [Claude Code](https://docs.anthropic.com/en/docs/claude-code) statusline.**

[](https://github.com/vincent-k2026/codachi/actions/workflows/ci.yml)

Why codachi?

• Context ETA — ~15m left tells you when to /compact, not just how full you are. The only statusline that predicts it.
• Event-aware pet — hooks watch Claude work and react with 850+ contextual messages, across 40+ event categories.
• codachi stats — local, zero-telemetry productivity dashboard: sessions, uptime, tier progress, last-24h test/commit/edit counts.
• Plugin API — drop a .mjs file into ~/.config/codachi/plugins/ to add your own palettes and messages. No forking required.
• i18n — bundled 简体中文; English fallback for any missing keys. BYO locale via CODACHI_LOCALE.
• Terminal-aware — auto-detects truecolor / 256-color / 16-color / monochrome and degrades gracefully. NO_COLOR honored.
• Zero overhead — no API calls, no tokens consumed. Local JSON + disk. Render p95 is ~0.1ms (verified by npm run bench).

---

Quick Start

One line. That's it.

npx codachi init

This wires up your `~/.claude/settings.json` statusline and PostToolExecution hook. Restart Claude Code and your pet will hatch.

Prefer a global install? `npm install -g codachi && codachi init` works too.

**Useful commands once installed:**

npx codachi stats             # productivity dashboard (sessions, uptime, tiers)
npx codachi plugins           # list loaded plugins
npx codachi config            # interactive TUI configurator
npx codachi demo              # live preview without installing

From source (if you want to hack on it)

git clone https://github.com/vincent-k2026/codachi.git
cd codachi && npm install && npm run build
node dist/index.js init

Manual setup (without init command)

Add to `~/.claude/settings.json`:

{
  "statusLine": {

...