NEXUS Quest

 _   _  _______   ___   _ _____
| \ | ||  ___\ \ / / | | /  ___|
|  \| || |__  \ V /| | | \ `--.
| . ` ||  __| /   \| | | |`--. \
| |\  || |___/ /^\ \ |_| /\__/ /
\_| \_/\____/\/   \/\___/\____/

 _____ _   _ _____ _____ _____
|  _  | | | |  ___/  ___|_   _|
| | | | | | | |__ \ `--.  | |
| | | | | | |  __| `--. \ | |
\ \/' / |_| | |___/\__/ / | |
 \_/\_\\___/\____/\____/  \_/

"The terminal is not legacy. It is the only honest interface the machine has. Everything else is theater."

You wake up with a contract on your screen. No client name. No callback address. Just:

NEXUS CORP MAINFRAME  //  INTERNAL FRAUD SUSPECTED
EVIDENCE BURIED ACROSS MULTIPLE INFRASTRUCTURE LAYERS
EXTRACT BEFORE THE MORNING ROTATION
    — ANONYMOUS

You are Ghost — a contract operative with one rule: no exploit kits. No zero-days. Just your terminal, your knowledge, and eight layers of systems between you and the truth.

The catch: every skill you need, you have to learn for real.

Keywords: terminal RPG, learn bash, learn git, learn docker, learn vim, learn SQL, learn Python, command line tutorial, hacker game, cyberpunk learning game, DevOps training, terminal game

What You'll Learn

760+ challenges across 109+ zones. Real commands. Real syntax. Real production skills.

Install

The easy way (recommended)

Mac / Linux:

pip install nexus-quest

Windows — open PowerShell and run:

pip install nexus-quest

If nexus-quest is not found after install: Open a new terminal window. If still missing, run python -m nexus_quest.main as a fallback.

Best experience on Windows: Use Windows Terminal (free, Microsoft Store). The default cmd.exe may display characters incorrectly.

One-liner installer (no pip? start here)

Mac / Linux:

curl -sSL https://raw.githubusercontent.com/thorski1/nexus-quest/main/install.sh | bash

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/thorski1/nexus-quest/main/install.ps1 | iex"

Then open a new terminal and run nexus-quest.

Auto-updates

The game checks for updates automatically at startup. When a new version is available you'll see:

╭──────────────────────────────╮
│      SOFTWARE UPDATE         │
│                              │
│  Update available!           │
│  Installed : v1.0.0          │
│  Latest    : v1.1.0          │
╰──────────────────────────────╯
  Install update now? [y/N]

Type y and the game installs the update and restarts itself.

Running

Gameplay

Each challenge teaches one concept through a short lesson, then asks you to demonstrate it:

• Knowledge Check — type the command, flag, or answer
• Live Challenge — run a real command in a sandboxed environment
• Flag Quiz — identify the correct option or syntax
• Fill in the Blank — complete the command or concept
• Matching — pair commands to their descriptions

  [h] Hint  [b] Bookmark  [d] Difficulty  [?] Help  [s] Skip  [q] Menu

Features

Progress saves automatically. Resume any time.

Requirements

• Python 3.10+
• A terminal emulator (Terminal.app, iTerm2, Windows Terminal)
• 80+ column width recommended

Built On

Quest Engine — a generic terminal RPG framework.

Narrative style inspired by Neal Stephenson's cyberpunk fiction.