Gotta train 'em all.

GitHub

A Pokemon companion lives in your Claude Code statusline. Every coding session earns XP. Your Pokemon levels up, evolves at the real game levels, and when fully evolved — a new wild encounter appears. Full-color ANSI sprite art rendered directly in your terminal.

Code more → earn XP → level up → evolve → catch 'em all. Gen 1 Kanto (151 Pokemon). Pokedex tracking. Type-colored UI. Zero config beyond install.

 🌿 TANGROWTH LV36 · #465 · Vine Pokemon · Gen 1
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━──────────────
      ▄██▄▄ ▄  ▄▄
    ▄ █▀██▀██▀█▀██▀▄
   ▀██▀ ▀▄██▀██▀█▀██▄
    █▀▄██▀▄██▄██▀ █▄▀█▀
     ▀█▀██▀▄▄▀█▄▀▄█▀█
      ▀ ▄█▄██▀█▀▀▀ █▄
       ▀██▀█▀▀ ▀██▀▀
       ▀▄▄▀▀    ▀█▀▀▀▄
                  ▀▀▀▀

Quick Start

Claude Code Plugin (recommended)

claude plugin marketplace add josheche/statusmon
claude plugin install statusmon@statusmon

Manual setup

git clone https://github.com/josheche/statusmon.git
cd statusmon && npm install && npm run build

Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "/path/to/statusmon/scripts/statusline-wrapper.sh"
  }
}

That's it. Open Claude Code — your starter Pokemon appears. Code normally. Watch it grow.

How It Works

Every Claude Code session generates tokens. Statusmon converts those tokens into XP:

session_xp  = floor(total_tokens / 7,500)
total_xp    = banked_xp + session_xp
level       = floor(total_xp / 3) + 1

XP banks automatically between sessions. Your Pokemon's level persists and grows over time. The XP bar shows progress toward the next level.

Evolution happens at the real game levels from PokeAPI — Charmander evolves at Lv.16, Charmeleon at Lv.36. When your Pokemon evolves, a full-color ANSI sprite announcement appears.

Release happens after your Pokemon is fully evolved and hits Lv.60 (or Lv.30 for non-evolving Pokemon). A new wild encounter appears — a fresh companion for your next journey.

Generations

Start with Gen 1 Kanto — the original 151 Pokemon. Unlock new generations by training:

Unlocking adds to the encounter pool — you can still find Gen 1 Pokemon after unlocking Gen 2.

Sprites

Full-color ANSI sprites rendered with bilinear interpolation using Unicode half-block characters (▀▄). Every Pokemon has a unique sprite pulled from PokeAPI.

Configurable size via sprite_size in ~/.statusmon/trainer.json:

Type Colors

The UI uses game-accurate type colors from the Pokemon games:

Name, XP bar, and accents are tinted with your Pokemon's primary type color.

Pokedex

Every Pokemon you train is recorded in ~/.statusmon/pokedex.json. Use the /pokedex slash command to browse your history — original species, final evolution reached, max level, dates trained.

# In Claude Code
/pokedex

Commands

State

All data lives in ~/.statusmon/:

~/.statusmon/
├── trainer.json       # Current companion + XP + generation
├── pokedex.json       # All encountered Pokemon history
└── cache/             # Cached PokeAPI responses + sprites

No database, no native deps, no compilation. Pure Node.js + pngjs + pokedex-promise-v2.

Works With

Statusmon chains with other statusline plugins. If TokenGolf is installed, both render together — your Pokemon companion above TokenGolf's efficiency HUD.

Architecture

statusline.mjs     → Reads trainer.json, computes level from session tokens,
                     renders sprite + info. Nearly pure render — writes only
                     when tokens grow by 10K+.
session-start.mjs  → Banks previous session's XP, checks generation unlocks,
                     pre-caches PokeAPI data. Runs once per session.
lib/evolution.mjs  → Evolution chains, level computation, release logic.
                     Uses pokedex-promise-v2 for PokeAPI access.
lib/sprite.mjs     → PNG → ANSI half-block art conversion with bilinear
                     interpolation. Configurable size.
lib/trainer.mjs    → State management for ~/.statusmon/trainer.json.
lib/pokedex.mjs    → Pokedex recording on Pokemon release.
lib/cache.mjs      → Sprite PNG download + filesystem cache.

_{Built with 🔥 by @josheche · Powered by PokeAPI}