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.

🎯 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, and cat

⚡ 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

rm is 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

📚 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. 🔨