codachi

codachi

A productivity copilot disguised as a tamagotchi, living in your Claude Code statusline.

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 900+ 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.

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:

From source (if you want to hack on it)

Manual setup (without init command)

Add to ~/.claude/settings.json:

Statusline Layout

Features

Your pet grows with context

The more context you use, the bigger your pet gets.

5 species, 5 moods, 10 palettes

Each session randomly assigns a species and color palette (or set them in config).

| Sleep | Context
All 30+ event categories

Testing (pass/fail) · Building (pass/fail) · Installing packages · Git (commit, push, pull, merge, rebase, stash, checkout) · Linting/formatting · Server start · Docker/K8s · Network/HTTP · Dangerous…