Behind a heavy iron door, the Vault holds the dungeon’s most powerful secrets — not gold and jewels, but the invisible variables that shape every shell. Set them correctly, or the ghost devours you.

🕹️ Play This Chamber

This page is your walkthrough and strategy guide — play right here in the browser, then follow the steps below.

🎯 Quest Objectives

• Set and read shell variables with = and $VAR
• Export a variable with export so child processes see it
• Use env and printenv to inspect the shell environment
• Solve the goblet puzzle in the stronghold
• Survive the ghost encounter in the lab
• Collect the vault key fragment

�️ Quest Prerequisites

• Cellar side-quest complete
• Emerald amulet in inventory

⚡ Command Cheatsheet

Local vs Exported Variables

# Local — child scripts cannot see this:
SECRET=password

# Exported — child scripts and subshells inherit it:
export SECRET=password

# Verify inheritance:
export GREETING="Hello Dungeon"
bash -c 'echo $GREETING'   # prints: Hello Dungeon

🗺️ Walkthrough

Step 1 — Enter the vault and read the stronghold scroll

cd .VAULT          # The vault may be hidden — use ls -a
ls -F
# stronghold/  nursery/  lab/  vault_scroll

cat vault_scroll

The scroll explains that each sub-area requires a specific environment variable to be set correctly.

Step 2 — Stronghold: solve the goblet puzzle

cd stronghold
ls -F
# goblet*  inscription

cat inscription
# "The goblet demands the colour of magic. Set MAGIC_COLOR before running ./goblet."

export MAGIC_COLOR="purple"
./goblet
# The goblet glows purple. Correct!
# Vault door unlocked.

Different game sessions may demand different values. Read the inscription carefully.

Step 3 — Nursery: learn about local variables

cd ../nursery
ls
# seeds  growth_chart  care_notes

cat care_notes
# "PLANT_NAME must be set to continue growing."

export PLANT_NAME="moonflower"
cat growth_chart

The nursery teaches that variables can store any string — command output, paths, names.

Step 4 — Lab: the ghost encounter

cd ../lab
ls -a
# ghost*  .formula  beakers/

cat .formula
# "To banish the ghost: set GHOST_BANISH to the name found in the beakers."

ls beakers/
cat beakers/vial_7
# Value: "iron_salt"

export GHOST_BANISH="iron_salt"
./ghost
# Ghost banished! The lab is safe.

If GHOST_BANISH is not set or wrong, ./ghost reduces your HP substantially.

Step 5 — Verify your environment

env | grep -E "MAGIC_COLOR|GHOST_BANISH|PLANT_NAME"
# MAGIC_COLOR=purple
# GHOST_BANISH=iron_salt
# PLANT_NAME=moonflower

Step 6 — Collect the vault key fragment

cd ..
ls -F
# vault_key_fragment

cat vault_key_fragment
inventory
# vault key fragment ✓

💡 Common Pitfalls

✅ Validation

• You understand the difference between local and exported variables
• You ran env and found your variables in the output
• The goblet puzzle is solved
• The ghost is banished
• The vault key fragment is in your inventory

➡️ Next Steps

• Complete other branches → Hidden Chapel · Scrap
• Enter the final gauntlet → The Rift
• Back to hub → Bashcrawl Hub

🖥️ 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).

📚 External Resources

Continue your terminal adventure with these resources:

• Bashcrawl Web Demo — Play in your browser, no installation required
• Bashcrawl on GitHub — Source code, setup, and open contributions
• GNU Bash Manual — Environment — Variables and the shell realm
• IT-Journey Bashcrawl Hub — Full quest series and walkthroughs
• Linux Environment Variables — Master the realm of variables

The ghost dissolves. Variables mastered. The vault yields its secrets. 🔒

🕸️ Knowledge Graph

Structured wiki-links connect this quest to the IT-Journey knowledge graph. Open the Obsidian Graph View to explore connections.

Level hub: [[Level 0000 - Foundation & Init World]] Overworld: [[🏰 Overworld - Master Quest Map]] Prerequisites: [[Bashcrawl Cellar: File Types, Aliases, and Emerald Amulet]] Unlocks: [[Bashcrawl Rift: Pipes, Redirection, and the Final Boss]] Sequel quests: [[Bashcrawl Rift: Pipes, Redirection, and the Final Boss]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]