[go: up one dir, main page]
Skip to content
Perch
The fastest way back to your agents.

Perch lives in your Mac’s notch. See what your coding agents did, answer them, jump back in.

Download for MacView the sourceFree and proudly open source
Version 0.5.5macOS 15 or laterApple silicon

Works with the agents and terminals you already use

  • Claude Code
  • Codex
  • OpenCode
  • pi
  • Conductor
  • Ghostty
  • Terminal
  • Warp
  • cmux
  • herdr

You walk away. Your agents don’t. Perch tells you what they did, right from the notch.

A morning with Perch.

You hand a few sessions to your agents and go do something else. Here is what the next few hours look like.

  1. 10:55

    While you work

    A session you are not in finishes or asks for something. The notch grows with what happened, then folds itself away.

  2. 12:10

    Where was I?

    Back from lunch, a card drops from the notch: the session, what the agent did, and the next step if it named one.

    ⌃⌥P

  3. 12:11

    Answer from the notch

    Allow or deny a command, or pick an answer to a question, without leaving what you are doing.

    AorD1to4

  4. 12:14

    Reply in place

    Read the agent’s last message and reply from the notch. It goes to the session, in a terminal or the Claude or Codex app.

    R

  5. 12:15

    Jump back in

    One key opens the exact session: the Claude app, Codex, a Conductor workspace, the terminal tab, the cmux split or the herdr pane.

    ↵

Built to stay out of the way.

It waits until you are back, stays quiet while you are not, and takes whatever you drop on it.

Make it yours

Pick a character and a colour. It lives behind the notch and only comes out when there is something to say.

Knows when to stay quiet

Quiet in calls. N snoozes it.

Drop files straight in

Drag a file to the notch.

Set up in a minute.

No account. Say hi, choose the agents it should watch, try your shortcut, and it is watching.

Questions

The short answers.

How do I get Perch?

Download it, open the .dmg and drag Perch to Applications. It is signed and notarized by Apple, and updates itself.

Is Perch free?

Yes. Perch is free and proudly open source, under the MIT license, and its code is on GitHub.

What do I need to run it?

An Apple silicon Mac on macOS 15 (Sequoia) or later, and Claude Code, Codex, OpenCode or pi, in its app or a terminal. A notch is optional.

Which agents and terminals work?

Claude Code, Codex, OpenCode and pi, in their own apps, in Conductor or in any terminal. Perch switches to the exact tab in Terminal, iTerm2, Ghostty and Warp, the exact pane in cmux and herdr, and the workspace in Conductor.

Does it send my data anywhere?

No. Perch reads the session files your agents already keep on your Mac, and your sessions, prompts and code never leave it. It goes online only to check for updates and, when you use it, to send feedback. The privacy page has the details.

What is live status?

An optional setting. It adds one hook entry for Claude Code and Codex and a small plugin for OpenCode and pi, so Perch hears the moment a session finishes or needs your OK. Your config files are backed up first, and turning it off removes everything it added.

Which permissions does it ask for?

Accessibility, for the shortcut and for typing a reply into the Claude or Codex app. Automation, to switch to the exact terminal tab. Files, to read project folders. Skip one and Perch still works: without Accessibility, a reply is copied for you to paste.

What happens the first time I open it?

macOS asks for Accessibility, for the shortcut and for replies. Updating from an earlier build? macOS asks once more, and Perch puts Allow right on its What’s new card.

Get Perch.

Download for MacView the sourceFree and proudly open source.Version 0.5.5macOS 15 or laterApple silicon

Like it? A star helps other people find Perch.Star it on GitHub