Local Development

Draft

These instructions are a draft. If something doesn’t work, ask on Ed.

Works on macOS, Linux, and Windows via WSL (on Windows, run everything below inside your WSL terminal).

1. Install Homebrew

From brew.sh:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Follow the “Next steps” the installer prints to add brew to your shell.

2. Install mise and gh

brew install mise gh

Activate mise in your shell, then restart the terminal:

echo 'eval "$(mise activate zsh)"' >> ~/.zshrc    # zsh (macOS default)
echo 'eval "$(mise activate bash)"' >> ~/.bashrc  # bash (most Linux/WSL)

3. Install Ruby

mise use -g ruby@3.3
ruby -v   # should print ruby 3.3.x

4. Sign in to GitHub

gh auth login

5. Editor

We recommend VS Code — on Windows, install the WSL extension and open your projects from inside WSL.