Bashcrawl Workshop: File Management Fundamentals
Practice mkdir, touch, echo redirection, cp, mv, and rm to construct workshop artifacts and advance deeper into Bashcrawl.
The Workshop smells of sawdust and old iron. Workbenches line the walls, covered in unfinished projects. Here, heroes learn the art of building — and destroying — the very fabric of the file system.
🕹️ Play This Chamber
This page is your walkthrough and strategy guide — play right here in the browser, then follow the steps below.
🎯 Quest Objectives
- Create a new room with
mkdir - Create a blank scroll with
touch - Write words onto a scroll with
echo > - Append text to a scroll with
echo >> - Copy a file with
cp - Move/rename a file with
mv - Remove an item with
rm - Clean the workshop and advance to the cellar
�️ Quest Prerequisites
- Complete the Entrance side-quest first
- Comfortable with
ls,cd, andcat
⚡ Command Cheatsheet
| Command | What It Does |
|---|---|
mkdir name |
Make a new directory |
touch file |
Create an empty file (or update timestamp) |
echo "text" |
Print text to the terminal |
echo "text" > file |
Write text to file (overwrites) |
echo "text" >> file |
Append text to file |
cp src dest |
Copy a file |
mv src dest |
Move or rename a file |
rm file |
Remove a file (permanent — no trash) |
rm -r dir |
Remove a directory and its contents |
🗺️ Walkthrough
Step 1 — Enter the Workshop
# From the entrance:
cd workshop # path varies by game mode
ls -F
# Output: blueprint tools/ debris workbench/
Step 2 — Read the blueprint
cat blueprint
The blueprint tells you what to build. Common workshop task: create a storage room and write a manifest.
Step 3 — Create a new room
mkdir storage_room
ls -F
# storage_room/ appears
Step 4 — Create and write a scroll
touch manifest
echo "Iron bars: 10" > manifest
cat manifest
# Output: Iron bars: 10
echo "Copper wire: 5" >> manifest
cat manifest
# Output: Iron bars: 10
# Copper wire: 5
>overwrites the file.>>appends without destroying existing content.
Step 5 — Copy and move files
cp manifest storage_room/manifest_copy
mv manifest storage_room/manifest
ls storage_room/
# manifest manifest_copy
Step 6 — Clean up debris
rm debris
ls -F
# debris is gone
rmis permanent — there is no Recycle Bin in the terminal. Double-check filenames before deleting.
Step 7 — Leave the workshop
cd ..
# Back to entrance, then navigate to cellar
cd cellar
💡 Common Pitfalls
| Problem | Cause | Fix |
|---|---|---|
rm: directory: is a directory |
Trying rm on a dir |
Use rm -r dirname |
Accidental overwrite with > |
Used > instead of >> |
Recreate the file; always double-check |
No such file or directory |
Typo in filename | Use Tab to autocomplete |
| Created file in wrong place | Not in Workshop dir | pwd first; cd as needed |
✅ Validation
Before advancing:
- You can create directories and files from memory
- You understand the difference between
>and>> - You successfully cleaned the workshop
- You navigated back out to continue the main path
➡️ Next Steps
- Main path → Cellar
- 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
| Command | Mode | Best for |
|---|---|---|
./main.sh --interactive | Textual TUI (recommended) | A rich local interface — needs Python 3 + textual |
./main.sh --classic | Classic bash emulator | Systems without Python |
./main.sh --native | Native terminal | The full real-filesystem experience |
./main.sh --tutorial | Tutorial mode | Guided, step-by-step learning |
./main.sh --agent | Agent mode | AI automation and screenshots |
./main.sh --help | Help | All launcher options |
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: mastery through adventure
Every master builder started with a single mkdir. The workshop is behind 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]] Prerequisites: [[Bashcrawl Entrance: Your First Terminal Commands]] Unlocks: [[Bashcrawl Cellar: File Types, Aliases, and Emerald Amulet]] Sequel quests: [[Bashcrawl Cellar: File Types, Aliases, and Emerald Amulet]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]
🎁 Rewards
🕸️ Quest Network
Referenced by
- Loading…