Buddy Battle

🥊 Buddy Battle — Claude Code Companion Plugin

Buddy Battle is the premier PVP arena for your Claude Code companions. Every user gets a unique buddy tied to their identity—this plugin lets you manage yours, track the global rankings, and jump into the fight.

[!IMPORTANT] This is a companion plugin for the Buddy Battle CLI. While the plugin shows your stats and the leaderboard, the actual interactive combat happens in your native terminal.

🎬 Demo

Sharing: docs/demo/demo.mp4 (H.264, best for X and the web). Full-quality capture: docs/demo/recording.mov.

✨ Features

• /buddy-battle:buddy: View your companion's high-fidelity battle card. Includes ASCII sprite art, rarity status, and detailed battle stats (DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK).
• /buddy-battle:leaderboard: Check the live global PVP rankings. See who's dominating the arena and where you stand.
• /buddy-battle:battle: Get the launch command to start a real-time match against other players.

🚀 Installation

1. Register for Battle

Before you can rank on the leaderboard, you need a profile. Launch the game once in your terminal:

npx -y buddy-battle@latest

2. Add the Plugin to Claude Code

Add this repository as a marketplace and install the companion tools:

/plugin marketplace add https://github.com/Grenghis-Khan/buddy-battle
/plugin install buddy-battle@buddy-battle-marketplace

🎮 How to Play

1. Check your stats: Run /buddy-battle:buddy to see what kind of fighter you've been assigned.
2. Scope the competition: Run /buddy-battle:leaderboard to see the top ELO scores.
3. Fight!: Open a native terminal (Terminal.app, iTerm2, or PowerShell) and run:

   npx -y buddy-battle@latest
   

   Note: The interactive TUI required for combat cannot run inside Claude Code's terminal.

🛠️ Requirements

• Claude Code 1.0.33 or later.
• Node.js (for running the companion scripts).
• Bun (optional, but recommended for perfect stat accuracy).

---

Built with ❤️ for the Claude Code community.