# Tutorials

**Learn aiterm through hands-on guides**

Step-by-step tutorials to help you master aiterm's features.

---

## 🎓 Getting Started

Perfect for beginners:

- **[Quick Start](../../QUICK-START.md)** - Your first 5 minutes with aiterm
- **[Installation](../../getting-started/installation.md)** - Complete installation guide
- **[First Steps](../../GETTING-STARTED.md)** - Essential commands and concepts

---

## 🖥️ Terminal Setup

Configure your terminal for optimal AI development:

### [Ghostty Configuration](ghostty-setup.md)

Learn how to setup and customize Ghostty terminal with aiterm.

**What you'll learn:**

- Theme and font configuration
- Ghostty 1.2.x features (titlebar styles, background images)
- Profile management
- Backup and restore

**Time:** ~30 minutes

---

### [StatusLine Setup](statusline-setup.md)

Configure the Powerlevel10k-style status bar for Claude Code.

**What you'll learn:**

- Install StatusLine into Claude Code
- Customize themes and spacing
- Configure display options
- Use Ghostty progress bars

**Time:** ~20 minutes

---

## 🔌 Integration Tutorials

Connect aiterm with your tools:

### [Claude Code Integration](../../CLAUDE-CODE-TUTORIAL.md)

Master Claude Code auto-approvals and settings management.

**What you'll learn:**

- Setup auto-approval presets
- Manage permissions
- Backup and restore settings
- StatusLine integration

**Time:** ~15 minutes

---

### [Gemini CLI Workflow](../../gemini-cli/GEMINI_TUTORIAL.md)

Integrate aiterm with Google Gemini CLI.

**What you'll learn:**

- Gemini CLI setup
- ADHD-friendly prompting
- Workflow automation
- Context management

**Time:** ~25 minutes

---

## ⚙️ Advanced Topics

For experienced users:

- **[Feature Workflow](../../guides/FEATURE-WORKFLOW-TUTORIAL.md)** - Git worktree-based development
- **[Git Worktrees](../../guides/GIT-WORKTREES-GUIDE.md)** - Multi-branch workflows
- **[Release Automation](../../guide/release-automation.md)** - Automated releases

---

## 📊 Interactive Learning

Try the built-in interactive tutorials:

```bash
# List available tutorials
ait learn list

# Start interactive tutorial
ait learn start

# Check your progress
ait learn progress
```

---

## 🎯 Learning Paths

### Path 1: Terminal Optimizer

1. Quick Start
2. Ghostty Configuration
3. Context Detection
4. Profile Switching

### Path 2: Claude Code Power User

1. Quick Start
2. Claude Code Integration
3. StatusLine Setup
4. Auto-Approvals

### Path 3: Workflow Automation

1. Quick Start
2. Feature Workflow
3. Git Worktrees
4. Release Automation

---

## 📚 More Resources

- **[Help Center](../index.md)** - All help topics
- **[Quick Reference](../quick-reference.md)** - Command cheat sheet
- **[Video Walkthrough](../../guides/VIDEO-WALKTHROUGH.md)** - Visual guide
