BashGod ⚡

Bash command trainer — build real shell fluency through scenario-based challenges, progressive difficulty, and instant feedback.

Target: Developers and admins who want to stop Googling basic commands.

Why this exists

No existing tool teaches bash fluency. Existing tools are either reference lookups (tldr, navi), static tutorials (linuxjourney), or security wargames (Bandit). Nobody helps you build the muscle memory of actually composing real commands.

Features

• Real-world scenarios — not "type ls" but "find all .log files over 100MB modified in the last 24h"
• Progressive difficulty — basic navigation → file ops → searching → processes → pipes & redirection
• Instant feedback — type a command, get told if it's right. Shows the explanation and a link to the man page
• Hints & skip — stuck? Get a hint or reveal the answer
• 9 categories — moving around, files, searching, processes, environment, text processing, pipes & redirection, permissions, network
• Runs in-browser — real terminal feel (xterm.js), no signup, no install. Just open and start drilling
• Open source — MIT licensed

Architecture

bashgod/
├── bashgod          # CLI entry point (bash wrapper)
├── src/
│   ├── scenarios/   # Challenge definitions (YAML)
│   ├── blitz.sh     # Core game engine
│   ├── scoring.sh   # Scoring calculation
│   └── tui.sh       # Terminal UI
├── web/             # React SPA (xterm.js)
│   ├── src/
│   │   ├── App.tsx
│   │   ├── TerminalGame.tsx
│   │   ├── game.ts
│   │   └── scenarios.json
│   └── ...
├── data/
│   └── profiles/    # User progress data (JSON)
└── tests/

Quick Start

Web (recommended)

Visit bashgod.com — no install needed.

CLI

git clone https://github.com/dairycow/bashgod.git
cd bashgod
./bashgod          # Start training

Roadmap

• More scenarios (difficulty 3, Docker, GPU/AI, networking)
• Daily challenge
• Spaced repetition (weak areas resurface)
• npx bashgod CLI version
• Leaderboards

License

MIT