whatisgithub

What is gauntlet?

darkly22/gauntlet — explained in plain English

Analysis updated 2026-05-18

55HTMLAudience · vibe coderComplexity · 2/5Setup · easy

In one sentence

A Pokemon battle engine you play by chatting with Claude Code, with real Pokemon data pulled live from PokeAPI.

Mindmap

mindmap
  root((GAUNTLET))
    What it does
      Pokemon battle engine
      Played via chat
    Tech stack
      Node.js
      Claude Code
      PokeAPI
    Use cases
      Arcade streak mode
      Narrated campaign
    Modes
      Draft battler
      Journey mode
      Web multiplayer
    Audience
      Vibe coders
      Pokemon fans

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play an endless roguelike Pokemon battler by chatting with Claude Code

USE CASE 2

Run a narrated Pokemon campaign where Claude acts as game master

USE CASE 3

Host a multiplayer web version where Claude narrates for every visitor

USE CASE 4

Study a single-file JavaScript game engine that handles all battle math

What is it built with?

Node.jsJavaScriptClaude CodePokeAPI

How does it compare?

darkly22/gauntletshanyin-ai/story-to-gamejasonengcc/keyshot-studio-materials
Stars555457
LanguageHTMLHTMLHTML
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencevibe coderwriterdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

The optional multiplayer web version needs an Anthropic API key.

So what is it?

GAUNTLET is a Pokemon battle engine that runs inside a Claude Code session, played entirely through chat. It requires Node.js version 18 or newer and fetches all Pokemon data, including stats, moves, sprites, and catch rates, live from PokeAPI, a free public database. Installation is a single command that downloads the files and can also install the Claude Code command line tool if it is not already present. There are two ways to play. The first is an endless arcade mode where you draft a team, fight progressively harder waves of opponents, and try to build a winning streak, similar to a roguelike game. The second is a narrated campaign mode where Claude acts as a Game Master, placing you on routes from the original Kanto region, letting you catch wild Pokemon, battle gyms, and build a story that saves to disk between sessions so you can continue later. In both modes, you make every strategic decision by typing plain language, such as "use the water attack" or "catch it." Claude translates what you say into game actions and reports the outcome, but the actual battle math, including type matchups, damage, accuracy, and catch odds, is handled entirely by a single JavaScript game engine file. Claude never invents mechanics or numbers, it only reads engine output and relays it back to you as the referee, not the player. There is also an optional multiplayer web version where Claude narrates for every visitor at once, which requires an Anthropic API key and has separate notes on hosting and cost control. The arcade mode alone can also run directly in a terminal without Claude, by calling the game script on its own, so an internet connection is only needed to fetch and cache Pokemon data.

Copy-paste prompts

Prompt 1
Install GAUNTLET and start the slash gauntlet arcade mode
Prompt 2
Start a slash journey campaign and have Claude narrate my first Kanto route
Prompt 3
Explain how GAUNTLET's game engine calculates damage and catch odds
Prompt 4
Show me how to host the GAUNTLET web version with my own Anthropic API key

Frequently asked questions

What is gauntlet?

A Pokemon battle engine you play by chatting with Claude Code, with real Pokemon data pulled live from PokeAPI.

What language is gauntlet written in?

Mainly HTML. The stack also includes Node.js, JavaScript, Claude Code.

How hard is gauntlet to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is gauntlet for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.