Racks of weapons line the walls. Suits of armour stand at attention. But every sword and potion is locked behind a permission barrier — you must learn chmod before you can equip a single item.

🕹️ Play This Chamber

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

🎯 Quest Objectives

• Read ls -l output and interpret permission bits
• Use chmod to make scripts executable
• Run ./potion to restore health
• Run ./sword to equip your weapon
• Defeat the armoury guardian
• Proceed to the Chamber

🗺️ Quest Prerequisites

• Cellar side-quest complete
• Comfortable with ls -F, cat, and file navigation

⚡ Command Cheatsheet

Permission String Decoder

-  rwx  r-x  r-x
│   │    │    │
│   │    │    └── others (o)
│   │    └─────── group (g)
│   └──────────── user / owner (u)
└──────────────── file type: - = regular, d = dir, l = link

Each group: r = read (4), w = write (2), x = execute (1)

Octal shorthand: 755 = rwx r-x r-x, 644 = rw- r-- r--

🗺️ Walkthrough

Step 1 — Inspect the armoury

ls -l
# -rw-r--r-- 1 user group  512 Jan  1 00:00 potion
# -rw-r--r-- 1 user group 1024 Jan  1 00:00 sword
# -rwxr-xr-x 1 user group  256 Jan  1 00:00 guardian

potion and sword lack the x bit — they are not yet executable. You cannot run them.

Step 2 — Try running a locked script

./potion
# bash: ./potion: Permission denied

This is the expected result. Now fix it.

Step 3 — Grant execute permission

chmod +x potion
chmod +x sword
ls -l potion sword
# -rwxr-xr-x 1 user group  512 Jan  1 00:00 potion
# -rwxr-xr-x 1 user group 1024 Jan  1 00:00 sword

Why the ./? When you type ./potion, the ./ tells the shell to run the script in the current directory. Without it, the shell only searches the directories in your PATH — and . (the current directory) is not in PATH by default, so potion alone would fail with “command not found”.

Step 4 — Drink the potion

./potion
# HP restored: 50 → 100

Step 5 — Pick up the sword

./sword
# Sword of Echoes added to inventory.

Step 6 — Face the guardian

./guardian
# A stone golem steps forward...
# You raise your sword...
# Guardian defeated! The door creaks open.

With the sword equipped, the guardian falls and the door to the Chamber opens. List the room (ls) to find the path onward, then step through into the Chamber’s directory (for example, cd ../chamber).

Low on health? Your HP carries over between rooms. If a fight leaves you weakened, re-run ./potion (if a potion is still available) before moving on.

💡 Understanding Octal Permissions

Security note: Never use chmod 777 on scripts or sensitive files. Use 755 for scripts and 644 for data.

💡 Common Pitfalls

✅ Validation

• You can read a permission string like rwxr-xr-- without looking it up
• You understand why ./ is needed to run a script
• You ran both ./potion and ./sword successfully
• The guardian is defeated and the Chamber door is open

➡️ Next Steps

• Continue main line → Chamber
• Explore other branches → Chapel · Vault · Scrap
• 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 — Official Bash reference for brave heroes
• IT-Journey Bashcrawl Hub — Full quest series and walkthroughs
• chmod Calculator — Permission wizard for every adventurer

Sword in hand, potion consumed. The Chamber awaits. ⚔️

🕸️ 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 Chamber: Bash Arithmetic and the Statue Boss]] Sequel quests: [[Bashcrawl Chamber: Bash Arithmetic and the Statue Boss]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]