The dungeon gate groans open. Cool air pours out carrying the scent of ancient scrolls. This is where every hero begins — four commands, a brass key, and the courage to type.

🕹️ Play This Chamber

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

🎯 Quest Objectives

• Print your current location with pwd
• List the dungeon entrance contents with ls and ls -F
• Read the entrance scroll with cat
• Ask Merlin for a hint with the merlin command
• Collect the brass key and move to the cellar

�️ Quest Prerequisites

• A terminal with Bash (macOS, Linux, or WSL)
• Bashcrawl installed or running at bamr87.github.io/bashcrawl

⚡ Command Cheatsheet

🗺️ Walkthrough

Step 1 — Where am I?

pwd
# Output: /home/<user>/bashcrawl/ENTRANCE  (or similar)

pwd always shows your absolute path. Use it whenever you feel lost.

Step 2 — What’s here?

ls
# Output: scroll  cellar

ls -F
# Output: scroll  cellar/

The trailing / after cellar tells you it is a directory (a doorway to the next chamber). scroll has no marker — it is a plain text file.

Step 3 — Read the scroll

cat scroll

The scroll contains the first piece of the dungeon’s story and a clue about the brass key. Read it carefully — items and hints mentioned here matter later.

Step 4 — Ask Merlin

merlin

Merlin reads your current location and delivers a context-sensitive hint. Whenever you are stuck, merlin is your first stop.

Step 5 — Check your objectives

quest

The quest log shows what you need to do in the current chamber.

Step 6 — Enter the cellar

cd cellar
pwd
# Output: .../ENTRANCE/cellar

Congratulations — you have left the entrance. Continue to the Cellar walkthrough or explore the Workshop first.

💡 Common Pitfalls

✅ Validation

Before marking this side-quest complete, verify:

• You can explain what pwd returns without running it
• You know the difference between ls and ls -F
• You read the scroll and understand its clue
• You successfully navigated into cellar

➡️ Next Steps

You are now ready to explore deeper. Choose your path:

• Continue the main line → Cellar
• Side trip first → Workshop
• 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 heroes
• IT-Journey Bashcrawl Hub — Full quest series and walkthroughs
• The Linux Command Line — Free book covering every command you’ll meet

Four commands mastered. Hundreds to go. The dungeon opens before you. 🗝️

🕸️ 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]] Unlocks: [[Bashcrawl Workshop: File Management Fundamentals]] · [[Bashcrawl Cellar: File Types, Aliases, and Emerald Amulet]] Sequel quests: [[Bashcrawl Workshop: File Management Fundamentals]] · [[Bashcrawl Cellar: File Types, Aliases, and Emerald Amulet]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]