Catch Bytlings while you code.
Every coding session has a chance to spawn a Bytling. No buttons, no menus — just code and they come to you.
catchem-final-v5.mp4
- Install —
npm install -g catchem - Setup —
catchem setupdetects your platform and installs hooks - Code — Bytlings appear passively as you work
- Collect — browse your collection with an interactive terminal UI
That's it. No prompts, no menus, no energy systems. Just code and catch.
npm install -g catchemSetup runs automatically after install. To manually set up or reconfigure:
catchem setupAt the end of each coding session, there's a chance a Bytling appears:
✨ You caught a Blazard! (x3)
[Lv.2] ████░░░░░░ 5/7
╱╲╱╲
╱══╲ ╱╱╱╱
╱ ◆◆ ╲╱╱
╲ ── ╱═╗
╲══╱ ║
╚═╝~🔥╝
"A TOWN?! Finally, somewhere to overheat besides your CPU fan."
91 Bytlings inspired by your favorite characters from:
| Theme | Inspired By |
|---|---|
| Elemental Beasts | Pokemon |
| Galactic Warriors | Star Wars |
| Marvel Heroes | Marvel |
| Legends Arena | League of Legends |
| LOTR Legends | Lord of the Rings |
| Greek Myths | Greek Mythology |
| Egyptian Myths | Egyptian Mythology |
| Undead Horror | Horror |
All Bytlings are original characters with unique ASCII art and coding-themed descriptions.
| Tier | Chance | Color |
|---|---|---|
| Common | 50% | ⬜ White |
| Uncommon | 25% | 🟩 Green |
| Rare | 12% | 🟦 Blue |
| Epic | 7% | 🟪 Purple |
| Legendary | 4% | 🟧 Orange |
| Mythic | 2% | 🟥 Red |
Catch duplicates to level up your Bytlings. 13 levels with escalating thresholds.
Browse your collection in an interactive terminal UI with:
- Scrollable 3-column grid with windowed viewport
- Animated ASCII art (idle blinking, breathing, energy pulses)
- Rarity-colored borders and Bytling names
- Undiscovered Bytlings shown as masked silhouettes
- Detail view with full stats on Enter
- Level progress bars
- Discovery counter
Run it with:
catchem collectionOr use the /catchem-collection skill in Claude Code.
| Platform | Status | Tested |
|---|---|---|
| Claude Code | Supported | ✅ |
| Cursor | Supported | ❌ |
| GitHub Copilot | Supported | ❌ |
| Codex CLI | Supported | ❌ |
| OpenCode | Supported | ❌ |
| Gemini CLI | Supported | ❌ |
| Command | What it does |
|---|---|
catchem setup |
Detect platforms, install hooks and skills |
catchem setup --auto |
Silent setup (used by postinstall) |
catchem collection |
Open interactive TUI collection viewer |
catchem help |
Show help message |
During setup, you can opt in to daily auto-updates. When enabled, a background check runs once per day and updates CatchEm silently via npm update -g catchem.
Found a bug? Have an idea for a new Bytling or theme? Open an issue.