_   __      _   __                     ____  _____
   / | / /___  / | / /___ _____ ___  ___  / __ \/ ___/
  /  |/ / __ \/  |/ / __ `/ __ `__ \/ _ \/ / / /\__ \
 / /|  / /_/ / /|  / /_/ / / / / / /  __/ /_/ /___/ /
/_/ |_/\____/_/ |_|\__,_/_/ /_/ /_/\___/\____//____/

Screenshot from 2.0.0, Tested in Termux via MyPhone myT10.

Screenshot from above of this screenshot is v0.3.1, current version (v3.0.0) has 44 games, 269 commands, and full color support not shown here.

One file. Zero dependencies. 44 games. 269 commands. One terminal.
Simulated OS meets sandbox playground — all in a single .cpp

A pure C++ terminal operating-system simulation featuring an interactive shell with pipes, scripts and persistence, a virtual filesystem, 44 built-in games, and 269 commands — all contained in a single source file.
No external dependencies. No framework. No build system headaches. Just compile and run.

Note: NoNameOS is not a real operating system. It is a C++ simulation that mimics an OS environment with a shell, virtual filesystem, games, and built-in tools. This repo is vibe-coded, but AGENTS.md makes this repo stable and it works.

• C++ learners wanting to see real OS concepts without kernel-level complexity
• Students exploring filesystems, shells, and process simulation hands-on
• Hackers looking for a terminal sandbox packed with games and tools
• Termux users craving a fun single-file project to compile in under 10 seconds

• Why NoNameOS?
• Perfect For
• Features
• What's New in v3.0.0
• Quick Start
• Keyboard Shortcuts
• Build Instructions
• Command Reference
• Games
• Easter Eggs
• Custom Maps
• Architecture
• What You'll Learn
• FAQ
• Platform Requirements
• Tech Stack
• Fun Facts
• Version History
• Contributing
• License

• Pipelines — cat file | grep x | sort | wc (stdout→stdin between commands)
• Redirections — ls > out.txt, cat a >> b, and < input redirection
• Chaining — cmd1 && cmd2 (short-circuit), cmd1 ; cmd2
• Glob wildcards — cat /docs/*.txt, rm test_* (matched against the VFS)
• TAB completion — completes commands, aliases, and VFS paths at the prompt
• Ctrl+R — reverse-i-search through command history

• .nnsh scripts: run script.nnsh args… with set k=v, $var $1-$9 $@, and one-line if A == B then cmd
• Session persistence: VFS, aliases, users, packages auto-saved to ~/.nonameos.vfs on exit and restored on boot
• save / load / persist on|off for manual control

• chess — full-rules chess vs greedy-2-ply AI: castling, promotion, check/checkmate detection
• clicker — idle coin clicker with 5 upgrades; progress persists (offline earnings up to 8h)
• pet — tamagotchi that decays in real time between sessions (pet feed/play/sleep/clean/name)
• fishing — cast, wait for the bite, react fast; rarity table + catch log (fishing stats)

• Color themes — theme set matrix|dracula|ocean|sunset|mono swaps the whole palette (saved)
• Custom prompt — prompt set "[%t] %u@%d > " with %u %h %d %t %% tokens (saved)
• Package manager — pkg install figlet|nyancat|starwars|sheep unlocks bonus toys
• news MOTD headlines, crunch column math, pack/packlist/unpack archiver, laps-capable stopwatch

• othello — classic Reversi vs. AI (2-player hotseat too)
• mastermind — crack the secret color code in 10 guesses
• simon — follow the growing light sequence
• blackjack — beat the dealer with real card logic
• battleship — sink the AI fleet with a smart-grid hunt
• slots — 3-reel slot machine with jackpots
• maze — escape an 18×14 maze, generated per run
• nim — take-the-last-stone strategy game
• buzz — the 3/5 FizzBuzz challenge vs. AI
• bulls — cows & bulls number deduction
• twentyone — simplified blackjack variant
• jumble — unscramble words across 5 categories
• arith — rapid-fire mental math quiz
• bingo — auto-generated bingo card

kernel, boot (animated reboot), shutdown (halts the OS), netstat, dns, traceroute, lsblk, mount, fib, primes, collatz, sine, cube, shell (toy sub-shell), logout, report, mac, geoip, dict, log

llm (fake AI chat), gpt, blockchain (fake mining), mine, neo, rabbit, dlc, kitchen, toaster, canon

spinner, progress, gauge, rain, fire, stream (matrix-style), type (typewriter)

• help now lists v2.0 categories: Games, System, Tools, Easter Eggs, Effects
• Version bumped to v2.0.0 — the biggest feature drop yet

• Fixed 2 critical Sudoku infinite loops in initialization
• Fixed setfill('0') state leak across commands
• Fixed 5 dead easter eggs (moved inside primary handlers)
• Fixed hangman — now draws complete figure at game end
• Fixed Tic-Tac-toe error pause in raw mode
• Added cin.ignore before cin.get() in all 21 prompts
• Added quit mechanism to guess game
• Fixed 2048 duplicate win message
• Whack-a-mole '0' now triggers miss as documented
• World clock uses UTC offset math (no global TZ modification)
• Tetris J-piece now has 4 rotations
• kbhit/getkey use static peek buffer (race-free)
• CSV separator width fixed

• Global arrow key support in all 7 real-time games
• Shell readline with cursor movement, backspace, history navigation
• 25+ easter eggs (sudo, konami, rickroll, disco, matrix, etc.)

• 11 new games: Tetris, Pong, Sudoku, Flappy Bird, Memory Cards, Connect Four, Lights Out, Sliding Puzzle, Breakout, Whack-a-Mole, Wordle, Quiz
• 60+ new commands: Converters, math tools, text processing, fun utilities
• Enhanced visuals: 256-color ANSI, truecolor RGB, animated boot, styled prompts

git clone https://github.com/Mark44928/NoNameOS.git && cd NoNameOS && g++ -O2 NoNameOS.cpp -o nonameos -lpthread && ./nonameos

One command. One file. One terminal. Pure C++ fun.

Or use make:

git clone https://github.com/Mark44928/NoNameOS.git && cd NoNameOS && make && ./nonameos

NoNameOS is written in pure C++ and uses POSIX headers. It compiles on any Linux-based system with a C++ compiler.

pkg install clang
clang++ -O2 NoNameOS.cpp -o nonameos -lpthread
./nonameos

sudo apt update && sudo apt install g++
g++ -O2 NoNameOS.cpp -o nonameos -lpthread
./nonameos

sudo dnf install gcc-c++
g++ -O2 NoNameOS.cpp -o nonameos -lpthread
./nonameos

sudo pacman -S gcc
g++ -O2 NoNameOS.cpp -o nonameos -lpthread
./nonameos

$ ./nonameos
    _   __      _   __                     ____  _____
   / | / /___  / | / /___ _____ ___  ___  / __ \/ ___/
  /  |/ / __ \/  |/ / __ `/ __ `__ \/ _ \/ / / /\__ \
 / /|  / /_/ / /|  / /_/ / / / / / /  __/ /_/ /___/ /
/_/ |_/\____/_/ |_|\__,_/_/ /_/ /_/\___/\____//____/

                    ═══════════════════════════════════════════
                     v3.0.0 · Pure C++ OS Simulation
                    ═══════════════════════════════════════════

  [━━━━━━━━━━━━━━━━━━━━━━━━━] System ready

  ✓ NoNameOS v3.0.0 booted successfully
  Type help for available commands
  ↑↓ history  ←→ cursor  Backspace delete


root@nonameos:/
❯ cowsay

  ────────
    Moo.
  ────────
          \   ^__^
           \  (oo)\_______
              (__)\       )\/\\
                  ||----w |
                  ||     ||


root@nonameos:/
❯ lolcat
NoNameOS

root@nonameos:/
❯ tableflip

  (╯°□°)╯︵ ┻━┻


root@nonameos:/
❯ banner

╔===========╗
║ NoNameOS  ║
╚===========╝


root@nonameos:/
❯

NoNameOS has 25+ hidden easter eggs. Try these:

Create your own AsciiDash maps using ^ for obstacles and _ for flat ground:

cd /geometry
echo mymap.gmd ____^^____^^^^____^___^
play mymap.gmd

The default map jumper.gmd is pre-loaded in /geometry/.

NoNameOS is a goldmine for C++ learners. Here's what each feature teaches:

No. NoNameOS uses POSIX headers (<termios.h>, <unistd.h>, <fcntl.h>) that don't exist on Windows. However, it works perfectly under WSL (Windows Subsystem for Linux) and Git Bash.

Type exit or press Ctrl+C. The TerminalGuard RAII class will restore your terminal settings automatically.

Yes. Use save to persist the VFS to ~/.nonameos.vfs, and load to restore it. Session persistence (persist on) auto-saves on exit and auto-loads at boot.

NoNameOS is a simulation for learning and fun. It has a shell, filesystem, and processes — but they're all implemented in userspace C++ code. There's no kernel, no hardware access, no real multitasking.

Yes! The entire project is one file. Find the command dispatcher (around line 5624) and add your own else if (cmd == "mycommand") block. Then recompile.

Because naming things is hard. The author couldn't decide on a name, so... NoNameOS it is.

• Linux (Termux on Android, Debian, Ubuntu, Fedora, Arch, etc.)
• A C++ compiler (g++ or clang++)
• POSIX-compatible system (uses <termios.h>, <unistd.h>, <fcntl.h>)
• Windows is not supported due to POSIX-only dependencies

┌─────────────────────────────────────────────────────────────────┐
│                        NoNameOS Architecture                                │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌──────────────┐    ┌─────────────────┐    ┌──────────────┐    │
│  │ Terminal I/O │───▶│  Shell (REPL)   │───▶│  Dispatcher  │    │
│  │ termios.h    │    │ cooked_readline │    │  if/else map │    │
│  │  fcntl.h      │    │ history, arrows │    │  269 cmds    │    │
│  └──────────────┘    └─────────────────┘    └───────┬──────┘    │
│                                                     │           │
│                    ┌────────────────────────────────┼─────┐     │
│                    │                                │     │     │
│           ┌────────▼───────┐              ┌─────────▼───┐ │     │
│           │  Virtual FS    │              │  44 Games   │ │     │
│           │  map<string,   │              │  Tetris     │ │     │
│           │    FSNode>     │              │  Snake      │ │     │
│           │  timestamps    │              │  Pong       │ │     │
│           │  permissions   │              │  Wordle     │ │     │
│           │  symlinks      │              │  ...        │ │     │
│           └────────────────┘              └─────────────┘ │     │
│                                                           │     │
│           ┌────────────────┐              ┌─────────────┐ │     │
│           │  System Tools  │              │   Easter    │ │     │
│           │  nano, calc    │              │   Eggs      │─┘     │
│           │  cfetch, top   │              │   25+       │       │
│           └────────────────┘              └─────────────┘       │
│                                                                 │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │  TerminalGuard (RAII) — auto-restores terminal on exit   │   │
│  └──────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

• Single-file C++ project — the entire OS in one .cpp file
• Zero external dependencies — only standard library + POSIX
• Compiles in ~10 seconds on a modern machine
• Runs on anything: Linux, macOS, Termux (Android), WSL
• 43 bugs found and fixed across 5 automated audit passes
• 25+ easter eggs hidden throughout the codebase
• Built with: C++, POSIX, and questionable life choices

Contributions are welcome! Here's how:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m "Add my feature")
4. Push to the branch (git push origin feature/my-feature)
5. Open a Pull Request

• Improve the AsciiDash engine with graphics
• Add more trivia questions and quiz content
• Add new games (Tetris Pong variants, puzzles, etc.)
• Add vim command with basic modal editing

This project is licensed under the GNU General Public License v3. See the LICENSE file for details.

• Anti-Bloatware List - Debloat rooted Android TV sticks

Found a bug? Open an issue. Made something cool? Submit a PR. Just here for the games? We don't blame you.

NoNameOS — because who needs a real OS when you can have 44 games and a terminal that judges your typing speed?