The cellar reeks of wine and secrets. Barrels line the walls; cobwebs drape the ceiling. Four iron doors lead deeper into the dungeon — armoury, chapel, vault, scrap. But first you must find the emerald amulet.

🕹️ Play This Chamber

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

🎯 Quest Objectives

• Identify every file type in the cellar using ls -F
• Use the file command to interrogate items
• Create a useful alias to speed up exploration
• Find and collect the emerald amulet
• Locate all four exits (armoury, chapel, vault, scrap)

�️ Quest Prerequisites

• Entrance side-quest complete
• Know how to use ls, cd, and cat

⚡ Command Cheatsheet

ls -F Symbol Key

🗺️ Walkthrough

Step 1 — Survey the cellar

ls -F
# Example output:
# emerald_amulet  armoury/  chapel/  vault/  scrap/  dusty_scroll  recipe*

Notice the variety: a regular file (emerald_amulet), directories (/), and an executable (recipe*).

Step 2 — Investigate with file

file dusty_scroll
# dusty_scroll: ASCII text

file recipe
# recipe: Bourne-Again shell script, ASCII text executable

file reads the file’s magic bytes — much more reliable than guessing from the name.

Step 3 — Read the scroll

cat dusty_scroll

The scroll reveals a clue about the emerald amulet’s location and warns about hidden traps in the deeper chambers.

Step 4 — Collect the amulet

cat emerald_amulet

Reading it adds it to your inventory. Verify:

inventory
# Shows: emerald amulet ✓

Step 5 — Create a helpful alias

# Quick inventory check shortcut
alias inv='inventory'

# Quick navigation shortcut
alias back='cd ..'

# Verify
alias

Aliases last only for the current session unless added to ~/.bashrc or ~/.bash_profile.

Step 6 — Identify all four exits

ls -F
# armoury/  chapel/  vault/  scrap/

Each leads to a distinct area of the dungeon. You can tackle them in any order.

💡 Common Pitfalls

✅ Validation

• You can explain every ls -F symbol from memory
• You created and tested at least one alias
• The emerald amulet is in your inventory
• You know which four chambers you can enter next

➡️ Next Steps

Choose your next chamber — all four are unlocked:

🖥️ 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 every hero
• IT-Journey Bashcrawl Hub — Full quest series and walkthroughs
• Bash Aliases Guide — Alias mastery for the brave adventurer

Emerald amulet secured. Four doors, four paths. The dungeon deepens. 🍷

🕸️ 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 Entrance: Your First Terminal Commands]] Unlocks: [[Bashcrawl Armoury: File Permissions and Script Execution]] · [[Bashcrawl Hidden Chapel: Hidden Files and Man Pages]] · [[Bashcrawl Vault: Environment Variables and the Goblet Puzzle]] · [[Bashcrawl Scrap Heap: Symbolic Links and Portal Creation]] Sequel quests: [[Bashcrawl Armoury: File Permissions and Script Execution]] · [[Bashcrawl Hidden Chapel: Hidden Files and Man Pages]] · [[Bashcrawl Vault: Environment Variables and the Goblet Puzzle]] · [[Bashcrawl Scrap Heap: Symbolic Links and Portal Creation]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]