Skip to content

hiddenpunch/tkm

 
 

Repository files navigation

🔴 Tokémon

Train Pokémon while you code.

A Gen 4 Pokémon XP gamification plugin for Claude Code. Earn XP from your coding sessions, level up, evolve, and catch 112 Sinnoh-region Pokémon.

Version License: MIT Node

English Guide · 한국어 가이드

Turtwig   Chimchar   Piplup


tokenmon status bar (WSL, Braille renderer)
Status bar with Braille renderer on WSL — Kitty/Sixel/iTerm2 renderers available for higher quality

Quick Start

# In a Claude Code session:
/plugin marketplace add ThunderConch/tkm
/plugin install tkm@tkm
/reload-plugins
/tkm:setup

The setup wizard guides you through dependency install, starter selection (Turtwig / Chimchar / Piplup), and status bar config.

Highlights

112 Pokémon Full Sinnoh Pokédex with 18 types
9 Regions Unlock new areas as you catch more
8 Legendary Unlock through Pokédex milestones & type mastery
Branching Evo Kirlia → Gardevoir/Gallade, Snorunt → Glalie/Froslass
Events Time-of-day type boosts, streak bonuses, milestone encounters
Dashboard Full stats, streaks, weekly activity, active events
21 Achievements Milestone rewards that unlock rare Pokémon
6 XP Groups Authentic leveling curves from the original games
Wild Encounters Battle and catch Pokémon mid-session
ANSI Sprites Terminal-rendered Pokémon art (Braille / Kitty / Sixel / iTerm2)
Cries & SFX Audio playback on level-up, evolution, and encounters
i18n English and Korean (한국어) fully supported

Commands

/tkm:tkm status          # Party & stats
/tkm:tkm dashboard       # Full summary dashboard
/tkm:tkm stats           # Weekly + all-time stats
/tkm:tkm party           # Detailed party view
/tkm:tkm box             # View stored Pokémon
/tkm:tkm party suggest   # Region-optimized party
/tkm:tkm evolve          # Branching evolution
/tkm:tkm legendary       # Legendary Pokémon
/tkm:tkm pokedex         # Browse Pokédex
/tkm:tkm region list     # Explore regions
/tkm:tkm achievements    # Achievement progress
/tkm:tkm help            # Full command list

Requirements

  • Claude Code v2.1+
  • Node.js ≥ 22.0.0

Uninstall

/tkm:uninstall          # Clean up data & statusLine first
/plugin uninstall tkm@tkm

License

MIT

About

Tokénmon — Gen 4 포켓몬 기반 Claude Code 경험치 플러그인

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 99.2%
  • Other 0.8%