Back to Exercises
Getting Started beginner 15 min

Terminal Canon Setup

Install WezTerm and apply your first Canon configuration.

Objectives

  • Install WezTerm on your system
  • Create a basic wezterm.lua configuration
  • Apply Canon colors (pure black background)
  • Verify the terminal recedes into use

Beads Tasks

Create these tasks in Beads before starting. You learn Beads by using Beads.

bd create "Install WezTerm via package manager" --type=task--labels=learn,getting-started
bd create "Create ~/.wezterm.lua configuration file" --type=task--labels=learn
bd create "Apply Canon color palette" --type=task--labels=learn
bd create "Restart and verify configuration" --type=task--labels=learn

Claude Code Prompt

Copy this prompt into Claude Code to build YOUR own version:

## Setup: Track this exercise with Beads

```bash
bd create "Install WezTerm via package manager" --type=task --labels=learn,getting-started
bd create "Create ~/.wezterm.lua configuration file" --type=task --labels=learn
bd create "Apply Canon color palette" --type=task --labels=learn
bd create "Restart and verify configuration" --type=task --labels=learn
```

---

Help me install and configure WezTerm as my terminal foundation.

I want a terminal that "disappears into use"—focused on the work, not the tool.

Walk me through:

1. **Install WezTerm** for my operating system:
   - macOS: `brew install --cask wezterm`
   - Linux: apt or flatpak
   - Windows: winget or installer

2. **Create the configuration file**:
   - Location: ~/.wezterm.lua
   - Start with a minimal Canon-aligned configuration

3. **Apply Canon colors**:
   - Background: pure black (#000000)
   - Foreground: white (#ffffff)
   - Minimal window chrome
   - No tab bar (we'll add tabs later)

4. **Configure for performance**:
   - Enable GPU acceleration
   - Set animation FPS to 120

5. **Verify it works**:
   - Restart WezTerm
   - Check that colors are correct
   - Confirm minimal chrome is applied

My operating system: [macOS/Linux/Windows]
Preferred font: [JetBrains Mono / your choice]

## Success Criteria

When complete, your terminal should:
- Have a pure black background
- Show white text with no color distractions
- Feel fast and responsive
- Show only the content, not the tool

This is Zuhandenheit: the tool recedes; only your work remains.

Your Solution

Write code that addresses the objectives above. Apply the principles from the Getting Started path.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Review the lesson