tuilder

Learn the terminal, Git & AI agents — from zero.
_{An interactive course in your terminal for designers, POs, CEOs — anyone who isn't a developer (yet).}

Website • Quick Start • Modules • Features • Contributing

---

🚀 Quick Start

npx tuilder

That's it. No installation needed. Works on macOS, Linux, and WSL.

Tip

You only need Node.js 18+ and a terminal. If you can read this, you can do it.

---

📖 What you'll learn

From "what is a terminal?" to collaborating on real projects with AI agents.

	Module	What you'll learn	Lessons
👋	Getting Started	Why you're here, what the terminal is, course controls	4
💻	Terminal Basics	Navigate folders, read files, create directories	12
🔀	Git Fundamentals	Save versions, create branches, understand the workflow	11
🤖	Your First AI Agent	Prompt AI, review diffs, approve or reject changes	11
🛠️	Your First Real Task	Navigate a real project and make changes with AI help	10
🧑‍🤝‍🧑	Team Collaboration	Pull requests, code review, merge conflicts	11
🎓	Graduation	Final quiz, review everything, earn your certificate	6

---

✨ Features

🎮 Interactive challenges Type real commands in a safe simulated terminal. Nothing you do can break anything. 🤖 AI agent simulation Practice prompting AI, reviewing diffs, and approving or rejecting changes. 💡 Progressive hints Stuck? Get a gentle nudge. Still stuck? Get the exact answer. No shame.

🌟 XP & levels Earn experience points, level up through 5 ranks, track your daily streak. 🌎 3 languages English, Spanish, and French. Choose at the start. 🎓 Certificate Complete all 65 lessons and earn a terminal-rendered graduation certificate.

Note

Press Tab at any time during the course to open the Cheat Sheet with all commands you've learned.

---

🔧 CLI Options

tuilder              # Start or continue the course
tuilder --reset      # Reset all progress
tuilder --lesson 3.1 # Jump to a specific lesson
tuilder --cert       # Show your graduation certificate
tuilder --lang en    # Change language (es, en, fr)

---

🏗️ Architecture

src/
├── app.tsx              # Root component (screen flow)
├── index.tsx            # CLI entry point
├── types.ts             # Lesson interface
├── theme.ts             # Color tokens
├── i18n/                # Internationalization (es/en/fr)
├── store/               # Progress persistence (~/.tuilder/)
├── components/          # Ink React components
│   ├── LessonFrame      # Core lesson UX (learn → task)
│   ├── CommandPrompt    # Command input with shake animation
│   ├── MultiCommandPrompt # Multi-step practice
│   ├── AgentSimulation  # AI agent session simulator
│   ├── CheatSheet       # Tab-toggled command reference
│   ├── Quiz             # Multiple choice quizzes
│   └── ...              # UI primitives
├── utils/               # Colorize, sound, XP calculations
└── lessons/             # 7 modules × 65 lessons

Built with: Ink v5 (React for the terminal) • React 18 • TypeScript (strict, ESM) • meow

---

🤝 Contributing

See CONTRIBUTING.md for guidelines on adding lessons, modules, and UI strings.

npm install
npm run build
node dist/index.js
npx tsx scripts/validate-course.ts  # Validate all 195 lessons

---

📄 License

MIT — Made with care by Omar Hernandez