Claudzooks

Learn the terminal and build your first web app with AI.

Getting Started (macOS)

1. Download this project and unzip it
2. Double-click Claudzooks (the app icon)
3. First time only: macOS will say it can't verify the developer — right-click the app, click Open, then click Open again
4. Your browser opens automatically — follow the lessons inside

That's it. No install required.

What You'll Learn

• Lesson 0: Welcome
• Lesson 1: Where am I? (pwd, ls, ls -la, clear)
• Lesson 2: Moving around (cd, mkdir, rmdir)
• Lesson 3: Working with files (touch, echo, cat, cp, mv, rm)
• Lesson 4: Reading and editing (head, tail, less, nano)
• Lesson 5: Putting it together — build a project folder from scratch
• Lesson 6: Meet your AI pair programmer (Claude Code)
• Lesson 7: Build something real

Development (contributors only)

Setting up a dev environment

Requires Bun.

# Install dependencies
cd app && bun install

# Start dev server (hot reload)
cd app && bun run dev

# Start command server (separate terminal)
bun server.ts

# Build for distribution
cd app && bun run build

The dev React app runs on http://localhost:5173 and connects to the command server on ws://localhost:5555/ws. The production build is served directly by server.ts on port 5555.