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.

This hub is your walkthrough and strategy guide to the game. Play instantly in the browser below, use the nine chamber walkthroughs as your field manual, then graduate to the advanced version — installing Bashcrawl and playing it in a real shell.

🕹️ Play in Your Browser

The full game runs right here — no install required. Keep this guide open alongside it.

🗺️ 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

🖥️ Advanced: Install & Play Locally

The embedded terminal above is the fastest way to play — but the advanced version runs Bashcrawl in a real shell on your own machine, with the full Textual TUI, agent mode, and a genuine filesystem sandbox. The walkthrough on this page works identically in either mode.

Option A — Clone the game

git clone https://github.com/bamr87/bashcrawl.git
cd bashcrawl
./setup.sh        # one-time setup: dirs, permissions, help system
./main.sh         # launch the adventure (interactive menu)

Option B — It already ships with IT-Journey

Bashcrawl lives in this repository as the submodules/bashcrawl git submodule. If you cloned IT-Journey, pull it down and play in place:

git submodule update --init submodules/bashcrawl
cd submodules/bashcrawl
./setup.sh
./main.sh --interactive

Play modes

Want to host the browser build yourself? From the game directory run make web-preview and open http://127.0.0.1:8000. The same static build is what powers the embedded terminal above (bamr87.github.io/bashcrawl).

🧙 In-Game Commands

⚔️ Combat Commands

🔧 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. ⚔️✨