Bashcrawl Quest: Terminal Adventure RPG
Embark on an epic terminal adventure that teaches Bash commands through nine interconnected dungeon chambers, each a dedicated walkthrough side-quest
Welcome to the Bashcrawl Catacombs — an interactive terminal dungeon where every command is a spell and every directory a new realm to explore. Nine interconnected chambers await, each a side-quest that teaches a core set of Bash skills through gameplay.
🗺️ Catacombs Map
flowchart TD
HUB([🏰 Bashcrawl Hub]) --> ENT[🚪 Entrance]
ENT --> WRK[🔨 Workshop]
ENT --> CEL[🍷 Cellar]
WRK --> CEL
CEL --> ARM[⚔️ Armoury]
CEL --> CHP[⛪ Hidden Chapel]
CEL --> VLT[🔒 Vault]
CEL --> SCR[🗑️ Scrap Heap]
ARM --> CHM[🐉 Chamber]
CHM --> RFT[🌀 The Rift]
CHP --> RFT
VLT --> RFT
SCR --> RFT
RFT --> AGT[🤖 Agent Mode]
click ENT "/quests/0000/side-quests/entrance/"
click WRK "/quests/0000/side-quests/workshop/"
click CEL "/quests/0000/side-quests/cellar/"
click ARM "/quests/0000/side-quests/armoury/"
click CHM "/quests/0000/side-quests/chamber/"
click CHP "/quests/0000/side-quests/hidden-chapel/"
click VLT "/quests/0000/side-quests/vault/"
click SCR "/quests/0000/side-quests/scrap/"
click RFT "/quests/0000/side-quests/rift/"
click AGT "/quests/0000/side-quests/agent-mode/"
📖 Chapter Guide
| # | Chamber | Difficulty | Key Commands | Walkthrough |
|---|---|---|---|---|
| 1 | 🚪 Entrance | 🟢 Easy | pwd ls cd cat |
Start Here |
| 2 | 🔨 Workshop | 🟢 Easy | mkdir touch rm echo > |
Workshop |
| 3 | 🍷 Cellar | 🟢 Easy | ls -F alias file |
Cellar |
| 4 | ⚔️ Armoury | 🟡 Medium | chmod ./ permissions |
Armoury |
| 5 | 🐉 Chamber | 🟡 Medium | let $(( )) arithmetic |
Chamber |
| 6 | ⛪ Hidden Chapel | 🔴 Hard | ls -a man hidden dirs |
Chapel |
| 7 | 🔒 Vault | 🟡 Medium | export $VAR env |
Vault |
| 8 | 🗑️ Scrap Heap | 🟡 Medium | ln -s readlink symlinks |
Scrap |
| 9 | 🌀 The Rift | 🔴 Hard | pipes \| && redirection |
Rift |
| ★ | 🤖 Agent Mode | 🔴 Hard | --agent --batch --screenshot-dir |
Agent |
⚡ Quick Start
# From this directory — choose your mode:
./bash_crawl.sh # Interactive menu
./bash_crawl.sh online # Open web browser version (no install)
./bash_crawl.sh local # Clone repo + launch Textual TUI
./bash_crawl.sh classic # Clone repo + classic Bash emulator
./bash_crawl.sh tutorial # Tutorial mode (step-by-step)
./bash_crawl.sh agent # Agent mode (AI playtesting)
./bash_crawl.sh --quest entrance # Print walkthrough URL then launch
🎮 Play Modes
| Mode | How to Launch | Best For |
|---|---|---|
| Web TUI | bamr87.github.io/bashcrawl | First playthrough, classrooms, no-install |
| Textual TUI | ./main.sh --interactive |
Beginners wanting a rich local interface |
| Classic Bash | ./main.sh --classic |
Systems without Python/Textual |
| Native Terminal | ./main.sh --native |
Full real-filesystem experience |
| Tutorial Mode | ./main.sh --tutorial |
Guided step-by-step learning |
| Agent Mode | ./main.sh --agent |
AI automation and screenshots |
🧙 In-Game Commands
| Command | Effect |
|---|---|
quest |
Show current quest objectives |
merlin |
Get a context-aware hint |
status or hp |
Show health and progress |
inventory or i |
List collected items |
map |
Display the dungeon map |
save |
Save current progress |
load |
Restore last save |
tutorial |
Toggle tutorial mode |
commands |
List all game commands |
help |
Show help screen |
reset |
Reset to a fresh start |
⚔️ Combat Commands
| Script | Chamber | Encounter |
|---|---|---|
./statue |
Chamber | Solve arithmetic to defeat the stone guardian |
./monster |
Chapel hall | Combat encounter — use weapon from Armoury |
./ghost |
Vault lab | Ghost encounter — environment variable skills required |
./goblet |
Vault stronghold | Solve the goblet puzzle; unlocks the path to the Rift |
🔧 Maintenance Commands
./setup.sh --verify # Check installation health
./setup.sh --repair # Fix common permission/setup issues
./main.sh --status # Show current game progress
./main.sh --reset # Reset for a fresh run
🧭 Learning Path Tips
- Start with Entrance → Workshop → Cellar to build confidence before branching.
- Keep a command journal: capture one new command and one mistake after each chamber.
- Replay one chamber in a different mode (Web, Classic, or Native) to reinforce transfer skills.
📚 External Resources
- Bashcrawl — Play Online
- Bashcrawl GitHub Repository
- The Spellbook: Bash Cheatsheet
- The Grand Grimoire: Complete Bash Reference
- Original Upstream — GitLab slackermedia/bashcrawl
🗺️ Quest Network
Quest Series: Bashcrawl Adventure Path
Prerequisites: None — this hub is a perfect entry point.
Child Quests: All nine chamber walkthroughs above (see Chapter Guide).
Sequel Quest: Bash Run and Beyond — extend the dungeon with custom scripting.
Ready? Run ./bash_crawl.sh or open Bashcrawl Online and type your first command. ⚔️✨
🎁 Rewards
200 XP
Badges
- 🏆 Terminal Explorer
- 🗝️ Dungeon Master
Unlocks
- Bashcrawl Entrance: Your First Terminal Commands
- Bashcrawl Workshop: File Management Fundamentals
- Bashcrawl Cellar: File Types, Aliases, and Emerald Amulet
- Bashcrawl Armoury: File Permissions and Script Execution
- Bashcrawl Chamber: Bash Arithmetic and the Statue Boss
- Bashcrawl Hidden Chapel: Hidden Files and Man Pages
- Bashcrawl Vault: Environment Variables and the Goblet Puzzle
- Bashcrawl Scrap Heap: Symbolic Links and Portal Creation
- Bashcrawl Rift: Pipes, Redirection, and the Final Boss
- Bashcrawl Agent Mode: AI Automation and Contribution
🕸️ Quest Network
graph TD
loading(["Loading quest graph…"])
Referenced by
- Loading…