Hello Claude - Claude Code Onboarding

A self-guided wizard to set up your development environment, powered by Claude Code.

Quick Start

1. Install Claude Code (if you don't have it):

   npm install -g @anthropic-ai/claude-code

2. Clone this repo:

   git clone https://github.com/zackmckennarunpod/hello-claude.git
   cd hello-claude

3. Run Claude Code:

   claude

4. Copy the example config:

   cp config.example.json config.json

5. Edit config.json with your name and preferences

6. Run Claude Code and say: "help me get started"

Claude will read your config and guide you through a personalized setup.

What You'll Set Up

• Ghostty - A fast, GPU-accelerated terminal emulator
• Zsh + Oh My Zsh - A powerful shell with plugins
• Powerlevel10k - A beautiful, informative prompt
• tmux - Terminal multiplexer for managing sessions
• Claude Code - AI-powered coding assistant
• Gastown - Multi-agent workspace coordination
• Beads - Git-backed issue tracking with Linear sync
• Linear MCP - Claude Code integration with Linear
• Notion MCP - Claude Code integration with Notion
• Playwright - Browser automation and testing
• gcalcli - Google Calendar CLI for terminal-based scheduling [OPTIONAL]
• Terminal Power Tools - fzf, bat, eza, jq, httpie [QUICK]

What You'll Learn

• How to navigate tmux like a pro (vim-style keybindings)
• How to split and manage terminal panes
• How to use Claude Code effectively
• Terminal productivity tips

Interactive Tmux Tutorial

After setup, there's a web-based tutorial for learning tmux:

cd tmux-tutorial
npm install
npm run dev

Then open http://localhost:3000 in your browser.

Files in This Repo

hello-claude/
├── CLAUDE.md           # Instructions for Claude (the wizard brain)
├── config.example.json # Example config (copy to config.json)
├── README.md           # You are here
├── steps/              # Step-by-step setup guides
│   ├── 01-prerequisites.md
│   ├── 02-ghostty.md
│   ├── 03-zsh-and-p10k.md
│   ├── 04-tmux.md
│   ├── 05-claude-code.md
│   ├── 06-first-project.md
│   ├── 07-gastown.md
│   ├── 08-linear-and-mcp.md
│   ├── 09-playwright.md
│   ├── 10-gcalcli.md         # [OPTIONAL] - Claude asks first
│   ├── 11-terminal-power-tools.md  # [QUICK] - Recommended for all
│   └── 12-notion-mcp.md          # [RECOMMENDED] - Notion integration
├── tmux-tutorial/      # Interactive web tutorial
│   ├── src/
│   ├── public/
│   └── package.json
├── exercises/          # Practice projects
│   └── hello-world/
└── reference/          # Quick reference cards
    └── tmux-cheatsheet.md

Need Help?

Just ask Claude! That's the whole point.

If Claude Code isn't installed yet, you can:

• Follow the steps manually in steps/ directory
• Check out the Claude Code documentation

Credits

Dotfiles: https://github.com/zackmckennarunpod/.dotfiles