# CLI-Games

> CLI-Games is a browser-based Linux terminal platform featuring 95+ ASCII games, live capture-the-flag (CTF) cybersecurity competitions, and a social command-line community. No downloads required.

For the complete knowledge base in a single file, see: https://www.cli-games.com/llms-full.txt

## What CLI-Games Is

CLI-Games replicates a Linux terminal environment in the browser. Users interact entirely through typed commands. The platform serves two audiences: experienced Linux users who want nostalgic terminal gaming, and beginners learning the command line through play.

The terminal supports standard Linux commands (ls, cd, cat, grep, find, awk, sed, etc.), a virtual filesystem, user profiles, friends lists, IRC-style chat, and a game library accessible by typing game names as commands.

## Platform Details

- URL: https://www.cli-games.com
- Type: Free web application (browser-based, no install)
- Tech: Next.js, React, WebAssembly for tool execution
- Input: Keyboard-only, command-line interface
- Auth: Optional account creation for saving progress and leaderboards

## Game Categories

### Classic Games (25+)
Terminal versions of board games and puzzles: chess (with Lichess puzzles, blindfold training, vision drills), minesweeper, checkers, battleship, connect four, wordie (daily word puzzle with streaks), sudoku, poker, blackjack, tic-tac-toe, snake, hangman, and more. All played by typing commands.

### Training / Cybersecurity (CTF)
Capture-the-flag training with two modes:

1. **Skills Tree (Static Training)**: 27 structured scenarios across reconnaissance, access control, credential attacks, privilege escalation, SQL injection, XSS, command injection, log analysis, path traversal, and network pivoting. Sandboxed environments with realistic Linux filesystems. Progress saves automatically.

2. **The Range (Live CTF)**: Daily competitions on real Linux infrastructure. Players connect to isolated Docker containers via browser terminal. Real attack boxes, real targets, real-time scoring. Spectator mode available. Challenges rotate daily.

### RPG / Text Adventures
Dungeon crawlers and narrative games built entirely in ASCII. Flagship series: "The Accidental Series" (Accidental Knighthood, Accidental Dragonslayer, Accidental Emperor) — a medieval comedy where a turnip farmer stumbles into legend. Also includes Dial-Up Days (1990s small-town network hacking adventure).

## Key Features

- **Live CTF Events**: Daily cybersecurity competitions with spectator mode
- **95+ Games**: Playable entirely through typed commands
- **PvP Multiplayer**: Challenge other players to chess, checkers, battleship
- **IRC Chat**: Real-time chat rooms with @mentions and notifications
- **Leaderboards**: Rolling 30-day rankings across all games
- **Player Profiles**: Public pages with badges, keys, and stats
- **Daily Challenges**: Chess puzzles, wordie, and CTF rotations
- **Clide AI**: In-terminal assistant that teaches without giving answers
- **Virtual Network**: Player-to-player networking with IP addresses, firewalls, and discovery tools
- **Wiki**: Command reference articles and game guides
- **Blog**: Technical deep-dives on cybersecurity, honeypot analysis, and platform architecture

## Terminal Commands

Users interact via standard Linux command syntax:
- `help` — list available commands
- `games` — browse the game library
- `chess`, `wordie`, `ctf`, `minesweeper`, etc. — launch games directly
- `man <game>` — read game manual
- `daily` — today's daily challenge
- `leaderboard` — view rankings
- `irc` — enter chat
- `profile` — view/edit profile
- `ping`, `nmap`, `whois`, `ssh` — network discovery and communication
- `ufw` — configure personal firewall

## Content Pages

- `/` — Landing page with platform overview
- `/games` — Full game library with search and filtering
- `/games/<id>` — Individual game pages with guides and features
- `/events` — Live and archived CTF competitions
- `/range/spectate` — Watch live CTF matches
- `/leaderboard` — Real-time player rankings
- `/wiki` — Command tutorials and game guides
- `/blog` — Technical articles and analysis
- `/faq` — Frequently asked questions
- `/players/<username>` — Public player profiles

## Documentation

- Wiki articles cover: awk, cat, cut, find, grep, head, sed, sort, tail, tr, uniq, wc
- Game guides: Chess training modes, opening principles, Wordie strategy, Dial-Up Days, The Accidental Series
- CTF overview: competition formats, skills that transfer, getting started

## Contact

- Website: https://www.cli-games.com
- For questions: Visit the FAQ at /faq or type `help` in the terminal