TUI Pokemon Crystal — 8 https://ryanculligan.com/crystal-agent-progress
  • TypeScript 96%
  • JavaScript 3%
  • CSS 0.3%
  • Zig 0.3%
  • Python 0.2%
  • Other 0.2%
Find a file
2026-06-20 10:35:39 -05:00
apps feat: simplify local runtime startup 2026-06-20 10:31:54 -05:00
img Better Desktop App (#1) 2026-06-15 18:17:20 -05:00
packages feat: simplify local runtime startup 2026-06-20 10:31:54 -05:00
scripts feat: simplify local runtime startup 2026-06-20 10:31:54 -05:00
supabase initial commit 2026-05-05 20:00:39 -05:00
.dockerignore initial commit 2026-05-05 20:00:39 -05:00
.gitattributes initial commit 2026-05-05 20:00:39 -05:00
.gitignore fix: update .gitignore to include additional build and generated directories 2026-06-15 19:27:50 -04:00
.npmrc initial commit 2026-05-05 20:00:39 -05:00
.pre-commit-config.yaml initial commit 2026-05-05 20:00:39 -05:00
AGENTS.md Better Desktop App (#1) 2026-06-15 18:17:20 -05:00
CONTRIBUTING.md initial commit 2026-05-05 20:00:39 -05:00
docker-compose.yml feat: update Docker configurations and enhance skill documentation for improved gameplay experience 2026-05-29 21:58:36 -04:00
Dockerfile.pokecrystal-ts.dev initial commit 2026-05-05 20:00:39 -05:00
LICENSE initial commit 2026-05-05 20:00:39 -05:00
package-lock.json Better Desktop App (#1) 2026-06-15 18:17:20 -05:00
package.json feat: simplify local runtime startup 2026-06-20 10:31:54 -05:00
README.md docs: add screenshots back to readme 2026-06-20 10:35:39 -05:00
tsconfig.base.json initial commit 2026-05-05 20:00:39 -05:00

Pokemon Crystal LLM Benchmarking Toolkit

Terminal and native desktop Pokemon Crystal runtime for live play and LLM gameplay experiments.

Battle

Start

Install once:

npm install

Start the TUI:

npm run start:tui

Start the native desktop app:

npm run start:desktop

Screenshots

TUI bedroom

Overworld

Desktop app

Agent view

Full text rendering

Lugia

Controls

  • Move: arrow keys, WASD, or HJKL
  • A: Z, J, or Space
  • B: X, K
  • Start: Enter
  • Select: Tab
  • Quit the TUI: :q!

Notes

  • Use Node.js 24.x and npm 10.5+.
  • npm run tui and npm run desktop are shorter aliases.
  • On first run, the start command fetches the upstream pret/pokecrystal sources and exports core runtime data only when local assets are missing.
  • To require preexisting local assets and skip that bootstrap, run with POKECRYSTAL_BOOTSTRAP_ASSETS=0.
  • TUI audio uses PCM; ffmpeg and MP3 audio export are not required to start the game.