Skip to content

Add pokemanion — a Pokémon that shows when Claude Code is working - #137

Open
khatriadbhut wants to merge 1 commit into
LangGPT:mainfrom
khatriadbhut:add-pokemanion
Open

khatriadbhut wants to merge 1 commit into
LangGPT:mainfrom
khatriadbhut:add-pokemanion

Conversation

@khatriadbhut

Copy link
Copy Markdown

Adds pokemanion to Development Tools & Utilities.

What it is

An ambient status indicator for Claude Code. A Pokémon sits in a terminal split beside the session — it rests while Claude is waiting on you, and animates while Claude is working. You can tell what state a session is in from across the room, without reading the screen.

  • 14 Pokémon ship with it; 1252 more can be summoned by name (--gengar, --random)
  • A built-in Pokédex (--dex pikachu, --dex random) that draws stats beside the sprite
  • Typing --squirtle at Claude switches the current pane — handled by a UserPromptSubmit hook, so it costs no turn and no tokens
  • Zero dependencies, plain Node, MIT licensed
  • Sprites are credited in ATTRIBUTION.md; there's a one-click issue form for artists who want theirs removed

The interesting part is underneath the sprites: Claude Code has no hook for pressing escape, so "is it actually busy?" has to be inferred from the session transcript. That, and the rest of the hook behaviour it depends on, is written up in docs/design.md.

Platform

macOS + Ghostty only, and the Notes column says so. It needs the kitty graphics protocol to draw sprites in a terminal cell, and it uses AppleScript to open the split. That limitation is stated plainly at the top of the README too, so nobody arrives expecting Linux support.

Checklist

  • Added to a single existing section, no new sections
  • Matches the four-column row format exactly (Name / Stars / Description / Notes)
  • Badge URL verified (returns 200)
  • One line changed, nothing else touched

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant