Buddymon — collectible Claude Code companion creatures via coding behavior #28

New issue

Open

opened 2026-04-01 13:33:09 -07:00 by pyr0ball · 0 comments

pyr0ball commented

2026-04-01 13:33:09 -07:00

Owner

Buddymon

A Claude Code plugin that turns your coding sessions into a creature-collecting game. Discover, catch, and level up companions through your real development work.

Core systems

Discovery — new Buddymon surface through coding behavior triggers:

First time using a language/library
Commit streaks, late-night sessions, deep focus runs
Specific error patterns, touching deprecated APIs
Completing challenges

Session assignment — assign a Buddymon to a session (like the color plugin). It gains XP from matching work based on its affinity type.

Bug monsters — errors and failing tests spawn creatures mid-session:

Different error types → different monsters (NullWraith, FencepostDemon, RacePhantom, CORSCurse, LoopLich, ShadowBit, etc.)
Monster strength scales with how long the bug persists
Choose to FIGHT (fix it → defeat → XP) or CATCH (weaken via good debug practices → add to roster)
Weakening requires: failing test, isolated repro case, or documentation comment
Some monsters only catchable, never defeatable (ShadowBit = security vulns)

Challenges — Buddymon proposes proactive goals at session start:

Type-matched to affinity (Tester → coverage goals, Cleaner → net negative lines, Streaker → commit runs)
Accept/decline/reroll
Completing challenges triggers new discovery encounters
Failing → Buddymon gets tired (reduced XP until rest session)

Evolution — Buddymon evolve at level thresholds, changing appearance and unlocking new challenge types

Roster

~/.claude/buddymon/ — local JSON registry (local-first; optional CF account sync later)

Mirrors

Forgejo: git.opensourcesolarpunk.com/Circuit-Forge/buddymon (primary)
GitHub: github.com/Circuit-Forge/buddymon
Codeberg: codeberg.org/Circuit-Forge/buddymon

Status

Design phase — plugin architecture TBD (fork of Thrumble companion plugin)

## Buddymon A Claude Code plugin that turns your coding sessions into a creature-collecting game. Discover, catch, and level up companions through your real development work. ### Core systems **Discovery** — new Buddymon surface through coding behavior triggers: - First time using a language/library - Commit streaks, late-night sessions, deep focus runs - Specific error patterns, touching deprecated APIs - Completing challenges **Session assignment** — assign a Buddymon to a session (like the color plugin). It gains XP from matching work based on its affinity type. **Bug monsters** — errors and failing tests spawn creatures mid-session: - Different error types → different monsters (`NullWraith`, `FencepostDemon`, `RacePhantom`, `CORSCurse`, `LoopLich`, `ShadowBit`, etc.) - Monster strength scales with how long the bug persists - Choose to FIGHT (fix it → defeat → XP) or CATCH (weaken via good debug practices → add to roster) - Weakening requires: failing test, isolated repro case, or documentation comment - Some monsters only catchable, never defeatable (`ShadowBit` = security vulns) **Challenges** — Buddymon proposes proactive goals at session start: - Type-matched to affinity (Tester → coverage goals, Cleaner → net negative lines, Streaker → commit runs) - Accept/decline/reroll - Completing challenges triggers new discovery encounters - Failing → Buddymon gets tired (reduced XP until rest session) **Evolution** — Buddymon evolve at level thresholds, changing appearance and unlocking new challenge types ### Roster `~/.claude/buddymon/` — local JSON registry (local-first; optional CF account sync later) ### Mirrors - Forgejo: git.opensourcesolarpunk.com/Circuit-Forge/buddymon (primary) - GitHub: github.com/Circuit-Forge/buddymon - Codeberg: codeberg.org/Circuit-Forge/buddymon ### Status Design phase — plugin architecture TBD (fork of Thrumble companion plugin)