Skip to main content

Collection of terminal CLI games

Project description

CLI Arcade

Collection of small terminal games bundled with a single CLI launcher.

Requirements

  • Python 3.8+

Quick start

# list installed console aliases and available games
clia list

# run interactive menu
clia

# run a game by zero-based index or name
clia run 0
clia run "Byte Bouncer"

# reset highscores for one game or all
clia reset 0
clia reset "Byte Bouncer"
clia reset -y  # skip confirmation

Commands

  • clia — interactive terminal menu
  • clia list — print available games and zero-based indices
  • clia run <index|name> — run a game directly (index is zero-based)
  • clia reset [<index|name>] [-y] — delete highscores for a game or all games
  • Aliases available: cli-arcade

License

  • MIT

Changelog

All notable changes to this project will be documented in this file.

2026.0.0

  • Initial release as CLI Game.

2026.1.0

  • Project renamed to CLI Arcade.
  • Packaging metadata updated for PyPI.
  • Documentation refresh.

2026.1.1

  • Updated TITLE ASCII art.
  • Added clia update command to check for and install updates from PyPI.
    • (YANKED)

2026.1.2 (YANKED)

  • Version bump for testing the update mechanism.

2026.1.3

  • Removed clia update command.

2026.2.0

  • Refactoring using prompt_toolkit replacing windows-curses for better cross-platform compatibility.
  • Restore/clear alternate screen on run/exit (no UI artifacts).
  • Centralize terminal-size checks in CLI; games expose MIN_COLS/MIN_ROWS.
  • Byte Bouncer & Star Ship: floor + off-screen right wall; left-column bug fixed.
  • ptk: default-attribute/color emission fix; add helper to exit alt screen.
  • Fixed 180 movement glitch in Star Ship.

2026.2.1

  • Updated key mapping to work with Linux and macOS terminals.

2026.3.0

  • Added scores command to CLI to display highscores for all games or a specific game, with optional raw JSON output.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cli_arcade-2026.3.0.tar.gz (157.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cli_arcade-2026.3.0-py3-none-any.whl (202.9 kB view details)

Uploaded Python 3

File details

Details for the file cli_arcade-2026.3.0.tar.gz.

File metadata

  • Download URL: cli_arcade-2026.3.0.tar.gz
  • Upload date:
  • Size: 157.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for cli_arcade-2026.3.0.tar.gz
Algorithm Hash digest
SHA256 258adf8093ecc88bde884a01f26644d756baf01d4e8285076db546e0cd239df7
MD5 557be2e4185a6002082089f5b4aa999e
BLAKE2b-256 89edf81180175145576ce5369ef5c5dc7fd5177bc2fa25120dbd3e81f62f4183

See more details on using hashes here.

File details

Details for the file cli_arcade-2026.3.0-py3-none-any.whl.

File metadata

  • Download URL: cli_arcade-2026.3.0-py3-none-any.whl
  • Upload date:
  • Size: 202.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for cli_arcade-2026.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8f3380a268758300d70ef7c3ca77b6e0badcf0f7fecaa569e6675310bd47c8ec
MD5 77250cdd6d1432715d532a11c64d1323
BLAKE2b-256 0d50be0f049f7c9305b83ece085550af8c4756b999f6fa049290e3f668f129f5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page