The Rift gate requires all four fragments
You stand at the edge of the Rift β a swirling chasm where data streams collide. The rules here are different: commands don't just run, they flow into each other. Master the pipe and you master the dungeon.
πΉοΈ Play This Chamber¶
This page is your walkthrough and strategy guide β play right here in the browser, then follow the steps below.
{% include bashcrawl-terminal.html room="The Rift" height="660" %}
π― Quest Objectives¶
- Pipe command output to another command using
| - Chain commands with
&&(run next only if previous succeeds) and||(run next only if previous fails) - Redirect stdout to a file with
>and>> - Redirect stderr with
2>and combined with2>&1 - Use
teeto split output to file and terminal - Navigate arena β pit β spire β mezzanine β .elevator β .satellite
- Defeat the pit boss and the satellite boss
- Complete the Bashcrawl dungeon
πΊοΈ Quest Prerequisites¶
All of these should be in your inventory before entering the Rift:
- Stone key fragment (from Chamber)
- Ancient tome (from Chapel)
- Vault key fragment (from Vault)
- Portal crystal (from Scrap)
β‘ Command Cheatsheet¶
| Syntax | What It Does |
|---|---|
cmd1 \| cmd2 |
Pipe stdout of cmd1 to stdin of cmd2 |
cmd1 && cmd2 |
Run cmd2 only if cmd1 succeeds (exit 0) |
cmd1 \|\| cmd2 |
Run cmd2 only if cmd1 fails (non-zero exit) |
cmd1 ; cmd2 |
Run cmd2 always, regardless of cmd1 exit |
cmd > file |
Redirect stdout to file (overwrite) |
cmd >> file |
Redirect stdout to file (append) |
cmd 2> err.log |
Redirect stderr to file |
cmd 2>&1 |
Redirect stderr to same destination as stdout |
cmd > out.log 2>&1 |
Redirect both stdout and stderr to file |
cmd \| tee file |
Print to terminal AND write to file |
πΊοΈ Walkthrough¶
Step 1 β Assemble the Rift Key¶
# The Rift gate requires all four fragments
ls -F
# arena/ rift_gate key_assembler*
inventory
# stone key fragment, tome fragment, vault key fragment, portal crystal β
# (inventory is a Bashcrawl game command, not a standard shell command β it lists what you carry)
./key_assembler
# All fragments combined β Rift Key obtained.
Step 2 β Arena β Master the pipe¶
cd arena
ls -F
# combatants scoreboard arena_boss*
cat combatants | sort | uniq
# Unique combatant list, sorted alphabetically
cat combatants | grep "elite" | wc -l
# Count of elite combatants
# Engage the arena boss
./arena_boss
The arena boss asks pipe-based puzzles. Answer by constructing the right pipeline.
Step 3 β Pit β Command chaining¶
cd ../pit
cat instructions
# "Raise the drawbridge ONLY if the watchtower lights up. Fail gracefully."
./watchtower && ./raise_drawbridge
# If watchtower succeeds: drawbridge raised.
# If watchtower fails: drawbridge untouched.
./watchtower || echo "Watchtower failed β lighting torches instead."
./pit_boss
Step 4 β Spire β Redirection¶
cd ../spire
cat spire_challenge
# "Capture all output from the oracle β both wisdom and errors β into oracle.log"
./oracle > oracle.log 2>&1
cat oracle.log
# Run again and APPEND to the same log instead of overwriting:
echo '--- additional run ---' >> oracle.log
./oracle >> oracle.log 2>&1
# Capture ONLY the errors (stderr) and leave wisdom on screen:
./oracle 2> errors_only.log
# Also capture everything with tee so you still see it:
./oracle 2>&1 | tee oracle.log
Step 5 β Mezzanine β Advanced chaining¶
cd ../mezzanine # mezzanine is a sibling of spire under the Rift root (like arena β pit β spire)
# Combine all techniques:
ls -la | sort -k5 -rn | head -10 > biggest_files.txt
# -k5 sorts by column 5 (file size); -rn is reverse numeric (largest first)
cat biggest_files.txt
Step 6 β Hidden areas: .elevator and .satellite¶
ls -a
# . .. .elevator/ .satellite/
cd .elevator
ls -F
# control_panel floor_select*
./floor_select
cd ../.satellite
ls -F
# transmitter* signal_logs satellite_boss*
cat signal_logs | grep "ERROR" | tee error_report.txt
cat error_report.txt
./satellite_boss
# Confirm the dungeon registers as finished:
map
# All chambers should now read as complete.
The satellite boss is the final encounter. It uses all skills: pipe a command through grep, redirect errors, chain with &&. Complete it to finish the dungeon.
π‘ Common Pitfalls¶
| Problem | Cause | Fix |
|---|---|---|
| not working |
Confused table escaping with shell syntax | In Markdown tables you write \\| to display a literal \|, but in the shell you always type a plain \| β never type \\| as a pipeline |
2>&1 must come AFTER > |
Order matters | Always: > file 2>&1 not 2>&1 > file |
&& chain stops early |
A command failed | Add \|\| fallback or check exit codes |
| Hidden dirs not found | Forgot ls -a |
Always use ls -a in unfamiliar directories |
β Validation¶
- You can build a 3-command pipeline from memory
- You know the difference between
>and>> - You understand why
2>&1must follow> - Both pit boss and satellite boss are defeated
-
mapshows all chambers as complete
β‘οΈ Next Steps¶
- The dungeon is complete! Celebrate your mastery.
- Capstone β Agent Mode for advanced automation
- Extend the dungeon β Bash Run
- Back to hub β Bashcrawl Hub
{% include bashcrawl-play-local.html %}
π 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 β Pipelines β The adventurer's guide to command chaining
- IT-Journey Bashcrawl Hub β Full quest series and walkthroughs
- Bash Redirections Cheat Sheet β Every spell for the master wizard
The Rift closes behind you. The dungeon is conquered. Every command a spell β every pipe a portal. πβοΈβ¨
πΈοΈ 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 Chamber: Bash Arithmetic and the Statue Boss]] Β· [[Bashcrawl Hidden Chapel: Hidden Files and Man Pages]] Unlocks: [[Bashcrawl Agent Mode: AI Automation and Contribution]] Sequel quests: [[Bashcrawl Agent Mode: AI Automation and Contribution]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]