Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (sudo-play) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

sudo-play 🕹️

Terminal-powered mini games for developers. Zero graphics. Maximum pain.

sudo-play is a plugin-based terminal arcade that runs entirely in your CLI. Each game is a self-contained module — challenging your developer instincts across regex, debugging, logic, and more. It's built to be fun, extensible, and dead simple to run.

Play Now

No installation required:

npx sudo-play

Or install globally to play any time:

npm install -g sudo-play
sudo-play

For local development:

npm install
npm run dev

The Idea

sudo-play was built for developers who live in the terminal. The concept is simple: a plugin-based arcade where each "game" is a TypeScript module that the engine discovers and loads automatically. You pick a game from the menu, play it, earn XP, and unlock more.

The architecture is intentionally minimal. The core engine knows nothing about individual games — it just defines a clean GameModule interface and a sandboxed GameContext that each game receives at runtime. This means anyone can add a new game by dropping a single directory into src/games/.

Games

Game	Description
🐛 Bug Hunter	Spot the bug in a code snippet and pick the right fix. 30s per challenge.
🔍 Regex Arena	Write regular expressions to match patterns across 5 progressive levels.

More games coming — contributions welcome.

How to Play

Run npx sudo-play (or npm start if developing locally)
Select a game from the interactive menu
Read the challenge, answer with your keyboard
Earn XP for correct answers — lose points for mistakes
Your progress is saved automatically between sessions

Documentation

Doc	Description
Architecture	How the engine, router, state, and plugin system work
Adding a Game	Step-by-step guide to building your own game plugin
Contributing	How to contribute code, games, or bug reports
API Reference	Full `GameModule` and `GameContext` interface reference

Tech Stack

Node.js + TypeScript (ESM)
@inquirer/prompts — interactive terminal prompts
chalk — terminal colours
tsx — dev-time TypeScript execution

sudo-play