Skip to content
perch

First run

The first time you open the Mac app, Welcome to perch shows what it found on its own: your Claude Code and Codex accounts, the sessions running, GitHub, tmux and your editors. Anything that changes your Mac (installing tmux, the editor extension, the permission hook) waits for a click. It’s in Settings → Setup afterwards.

A few things are worth a look in Settings (⌘,):

  • Accounts: check the names it gave your accounts, and pick a color for each.
  • Appearance → Look: Auto (purple when your Mac is dark), Purple, Dark or White.
  • Decisions → Answer permission prompts here: off until you turn it on. See Permission prompts.
  • Mac app → Open at login, so perch is there after a restart and can offer to reopen your sessions.
  • Usage: how close each account is to its plan’s limits.
  • Connections: whether the GitHub CLI, tmux and the editor extension are working.