Introduction

perch watches the coding agents already running on your Mac (Claude Code, and Codex in beta) and shows what each one needs from you. It doesn’t run them, and it doesn’t change how you work: keep using Cursor, iTerm, tmux, or anything else, across as many accounts as you have.

It answers three questions:

• What needs me? Permission prompts, questions, plans waiting for an OK, and sessions that finished their turn.
• What’s still working? Every running session, with its steps and its helper agents as they go.
• What’s ready to merge? Your pull requests, sorted by what each needs, and tied to the session that made it.
• What do I need to do? Tasks: what agents need from you, and your own side notes.

There’s a Mac app, a dashboard you can open in a browser, and an iPhone app that shows the same screens from anywhere.

Start with Install.