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

-rwxr-xr-x
│└──┘└──┘└──┘
│ u   g   o
│ user group others
└── 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 01 potion
# -rw-r--r-- 1 user group 1024 Jan 01 sword
# -rwxr-xr-x 1 user group  256 Jan 01 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 01 potion*
# -rwxr-xr-x 1 user group 1024 Jan 01 sword*

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...
# [combat sequence]

With the sword equipped, you should win. Health permitting, the guardian falls and the door to the Chamber opens.

💡 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]]