You have conquered the Rift. But the dungeon holds one final secret β a mode where an AI plays alongside you, a mode where you automate the entire journey, a mode where you become the dungeon master. Welcome to Agent Mode.
./main.sh --agent--batch--status to generate a dungeon completion report| Mode | What It Does |
|---|---|
./main.sh --agent |
AI playtesting mode β AI navigates autonomously |
./main.sh --agent-bash |
Agent mode in classic bash-only interface |
./main.sh --batch commands.txt |
Execute a list of commands from a file |
./main.sh --command "cmd" |
Run a single command inside the dungeon |
./main.sh --screenshot-dir ./shots/ |
Capture terminal screenshots while playing |
./main.sh --status |
Print dungeon completion status |
./main.sh --demo |
Run the built-in demo walkthrough |
./main.sh --reset |
Reset the dungeon to initial state |
Or use the IT-Journey launcher from the hub directory:
./bash_crawl.sh agent # Launches --agent mode
./bash_crawl.sh tutorial # Launches --tutorial mode
cd bashcrawl
./main.sh --agent
The Textual TUI launches. An AI agent (powered by llm if installed, otherwise heuristic-based) navigates the dungeon:
Watch to see if the AI takes different paths than you did. Note: the AI makes mistakes too.
Exit at any point: Ctrl+C or type quit.
mkdir -p ./walkthrough_screenshots
./main.sh --screenshot-dir ./walkthrough_screenshots --classic
# Play through the dungeon normally
# Screenshots auto-saved at each room
ls ./walkthrough_screenshots/
# entrance_01.png workshop_01.png cellar_01.png ...
This is the fastest way to create tutorial screenshots for blog posts, slide decks, or wiki contributions.
Create a file of commands to execute automatically:
cat > my_walkthrough.txt << 'EOF'
ls
cat scroll
cd ENTRANCE
ls -F
cat quest
cd WORKSHOP
ls -F
mkdir backpack
touch map.txt
echo "Items: sword, potion" > map.txt
cat map.txt
EOF
./main.sh --batch my_walkthrough.txt
Batch mode is ideal for:
./main.sh --status
Output example:
Bashcrawl Status
================
Version: 3.0.0
Areas Explored: 9/9 (100%)
Items Collected: sword, potion, emerald_amulet, stone_key, tome, vault_key, crystal
Bosses Defeated: guardian, monster, ghost, pit_boss, satellite_boss, statue
Completion: DUNGEON CLEARED β
Pipe it to a file:
./main.sh --status > my_completion.txt
cat my_completion.txt
./main.sh --demo
Demo mode runs a curated, annotated walkthrough that explains each command while executing it. Use this to:
The upstream Bashcrawl repo is open source and welcomes contributions:
# Fork on GitHub then:
git clone https://github.com/YOUR_USERNAME/bashcrawl.git
cd bashcrawl
git checkout -b feature/my-improvement
# Make changes (new rooms, better documentation, bug fixes)
# Example: add a new combat command
echo 'cast_spell() { echo "You cast $1!"; }' >> lib/combat.sh
git add .
git commit -m "feat(combat): add cast_spell helper function"
git push origin feature/my-improvement
# Open a Pull Request on GitHub
Ideas for contributions:
| Problem | Cause | Fix |
|---|---|---|
--agent fails |
llm not installed |
Install: pip install llm |
| Screenshots are blank | Terminal not supported | Try --classic mode with --screenshot-dir |
| Batch file hangs | A command waiting for input | Add \n for interactive prompts or use non-interactive commands |
--status shows incomplete |
Some area not fully explored | Check map inside the game |
--status shows all areas exploredComplete all 10 side-quests and you have earned the right to call yourself a Bashcrawl Dungeon Master:
| Badge | Criteria |
|---|---|
| π° Explorer | All 9 chambers explored |
| βοΈ Combatant | All bosses defeated |
| π Scholar | All man pages consulted |
| π€ Automator | Batch file run successfully |
| π Contributor | Pull request submitted upstream |
awk, sed, find, xargs quests at level 0001Continue your terminal adventure with these resources:
The dungeon is complete. The AI learned. The bash shell is your wand. Go forth and automate. π€π°β¨