AI-powered auto-battler in your terminal. Type a prompt. Forge a creature. Watch it fight.
npx openbrawl
You start with a box. It can do nothing. Each round, you type a creative prompt to give it weapons, abilities, armor, or allies. An AI game master interprets your words and shapes your creation. Then you watch it auto-battle a persistent rival that evolves alongside you.
Creative prompting is the strategy layer. "A parasitic vine-sword that drinks enemy blood" will always beat "a sword."
- Round starts -- each round has a category: Weapon, Defense, Special Ability, Recruit Ally, or Reshape/Evolve
- You prompt -- type a creative description within your word budget. Vivid prompts get stat bonuses.
- AI forges -- Claude interprets your prompt into stats, abilities, and mutations. Your rival evolves simultaneously.
- Auto-battle -- tick-based combat with HP bars, ability procs, and blow-by-blow action.
- Repeat -- survive 10 rounds to win. You have 5 lives.
- Claude Code CLI installed and authenticated
- That's it. No accounts, no servers, no API keys to configure.
Uses Claude Haiku via your own Claude Code tokens. A full 10-round game costs approximately $0.01.
| Key | Action |
|---|---|
F |
Start Forge Mode |
TAB |
Cycle tabs (Stats, Abilities, Mutations, History, Prompt) |
ESC |
Return to Prompt tab |
ENTER |
Submit prompt / Start battle / Next round |
Q |
Quit |
- Persistent rival with a name, personality, and adaptive strategy
- Tick-based combat where SPD determines attack frequency
- Emergent abilities -- the AI invents abilities, mutations, and synergies
- Creativity bonus -- vivid prompts get +10-30% stat budgets
- Parallel AI calls -- your creature and rival forge simultaneously
- Token tracking -- see exactly how many tokens and dollars each game costs
- Animated battle -- turns reveal one at a time with live HP bars
git clone https://github.com/frydzewski/openbrawl
cd openbrawl
npm install
npm run devMIT