@hypersocial/cli-games

18 terminal games that run in any xterm.js terminal or directly in your CLI.

Snake, Tetris, 2048, Pong, Asteroids, Space Invaders, Breakout, Frogger, Tron, Minesweeper, Wordle, Hangman, Simon, Runner, Tower, Typing Test, Crack, Chopper.

Originally built as easter eggs for HyperSpaces — the terminal for AI coding agents. Play games while your agents ship code.

Quick Start

# Play now — no install needed
npx @hypersocial/cli-games

# Launch a specific game
npx @hypersocial/cli-games snake

# With a color theme
npx @hypersocial/cli-games tetris --theme green

Install

# Global install
npm install -g @hypersocial/cli-games
cli-games

# Or as a project dependency (for xterm.js integration)
npm install @hypersocial/cli-games

CLI Usage

cli-games                    # Interactive game menu
cli-games <game>             # Launch a game directly
cli-games --theme <theme>    # Set color theme
cli-games --list             # List all games
cli-games --help             # Show help

Available Themes

cyan (default), amber, green, white, hotpink, blood, ice, bladerunner, tron, kawaii, oled, solarized, nord, highcontrast, banana, cream, and their light variants (e.g. cyanLight).

Library Usage (xterm.js)

import { games, setTheme, runGame } from '@hypersocial/cli-games';

// Set the color theme
setTheme('cyan');

// Run a game in an xterm.js Terminal instance
const controller = runGame('snake', terminal);

// Stop the game
controller?.stop();

// Browse all games
for (const game of games) {
  console.log(`${game.id}: ${game.name} - ${game.description}`);
}

Themes

import {
  themes,
  getTheme,
  getAnsiColor,
  getTerminalTheme,
  type PhosphorMode,
} from '@hypersocial/cli-games/themes';

// Get a full xterm.js theme object
const xtermTheme = getTerminalTheme('cyan');
terminal.options.theme = xtermTheme;

Games

Game	Description
Tetris	Stack the blocks
Snake	Eat and grow
2048	Slide and combine tiles
Runner	Jump and duck
Pong	Classic paddle game
Wordle	Guess the word
Minesweeper	Clear the mines
Hangman	Guess the word
Space Invaders	Defend Earth
Tower	Build a tower
Simon	Memory game
Frogger	Cross the road
Breakout	Break all the bricks
Asteroids	Shoot the rocks
Typing Test	Test your speed
Tron	Light cycle battle
Crack	Hack the system
Chopper	Deliver passengers

Controls

• Arrow keys or WASD — Move / navigate
• Enter — Confirm / select
• ESC — Pause menu
• Q — Quit

About

Built by Selcuk Atli at HyperSocial App Studio.

These games are the easter eggs inside HyperSpaces, a terminal built for developers running multiple AI coding agents across multiple projects. Think Discord for your terminals — projects in the dock, branches as channels, agents side by side.

Contributing

Contributions welcome via pull requests. Add a new game, improve an existing one, or fix a bug.

License

AGPL-3.0 — see LICENSE for details.