Skip to content

Black Friday: 40% off the Perch licence for the first 500 orders until 1 Dec, $17.40 instead of $29, with code BLACKFRIDAY2026. The deal

Changelog

Every Perch release, newest first.

The same notes Perch shows when it offers you an update. Perch updates itself; every release is notarized and signed.

0.5.147

Fixed

  • Codex conversations on your iPhone no longer show empty placeholder rows. Newer Codex versions record the tools they offer the model and reasoning-effort changes in the session; Perch now leaves those out of the conversation, since they aren't part of it.

0.5.146

Changed

  • Perch does less work when a Claude session has just started. It no longer searches every project folder for the session's transcript on each check before Claude has written one.
  • The Stats window and the Licence settings take less work to draw.

Fixed

  • Perch no longer takes over a Droid status line it didn't write. Installing or removing Perch's Droid integration now leaves your status line alone unless it is Perch's own.
  • A Claude session waiting on a permission keeps showing that it needs you, even when Perch briefly can't read the session's files.
  • Perch finds OpenCode's database in the same place OpenCode does when you set XDG_DATA_HOME or OPENCODE_DB in your shell.
  • When Perch can't move something to the Trash from Storage settings, it now tells you why.
  • Diagnostics now include Droid and Muse.

0.5.145

Changed

  • Perch uses less of your Mac while sessions run. It no longer re-reads Claude, Codex, OpenCode, Antigravity and Muse session files every few seconds when nothing in them has changed.

Fixed

  • The "needs you" label stays on one session when two sessions are waiting on you at once, instead of flipping between them.
  • Perch can no longer freeze while replying to an agent that has stopped listening; it gives up after half a second.
  • Perch's permission log is now readable only by your account, like its other logs.

0.5.144

Fixed

  • The menu bar stays on one project while several sessions run. Perch now keeps naming the same running session for at least 30 seconds instead of switching to whichever one last did something, so the label and the icons beside it stop jumping. A session that needs you still shows at once.
  • Answers to OpenCode questions are delivered reliably. Perch checks that your answer reached the agent, and a question whose agent has already gone away no longer shows up waiting for you.
  • Fixed a rare crash in Perch's status line helper when an agent sent an out-of-range number.

0.5.143

Fixed

  • The menu bar no longer jumps as the thinking word changes. While a session runs, Perch's label keeps the same width as its word rotates, so the icons beside it stay put.

Changed

  • The Settings window does less work while it's open, and stops working entirely once it's closed.

0.5.142

Fixed

  • Perch no longer freezes when a command it runs hangs. Your own Claude status line (when Perch wraps it), tailscale status and Keychain reads for usage now give up after a few seconds instead of waiting forever.
  • A Keychain that won't open no longer reads as "signed out". Perch keeps your usage bars and any "sign-in expired" warning instead of clearing them.
  • Uninstalling Perch's hooks leaves other tools' settings alone. Removing Perch from Codex, Cursor, Devin, Droid or Muse now takes out only Perch's own entries, backs the file up first, and checks the result, putting the file back if anything went wrong.

Security

  • Perch's own data files are private to your account. The status-line, cost and spend files Perch keeps could be created readable by other accounts on the Mac. They're now written private, and existing ones are tightened when Perch starts.
  • Perch double-checks its own data folder before tidying it at launch, so it never deletes or changes files somewhere else.

0.5.141

Added

  • Droid sessions that run in the cloud. Paste a Factory API key in Settings → General and Perch also shows Droid sessions running in Factory's cloud or on another machine: what tool they're using, when they finish, and a "needs you" alert when the agent asks you a question. Your key stays in your Keychain and is sent only to Factory.

Fixed

  • A Droid turn that fails no longer says "finished". When the model or provider fails, the session shows why it stopped (for example "provider unreachable" or a rate limit) instead of a finish.
  • Droid with its sandbox on updates again. Sessions that run their agent in a separate worker no longer freeze on the list, and their permission prompts reach Perch.
  • A Droid prompt queued in the terminal shows as running, and Perch tells you when it finishes.
  • A Droid session waiting on a background subagent no longer announces it finished early, and a denied permission reads as idle rather than waiting.

Changed

  • Perch does less work in the background while your sessions are quiet, so it uses less of your Mac's CPU.

0.5.140

Added

  • An agent's latest reply on your iPhone, with a Perch licence. Tap a session in Perch on iPhone to see the agent's most recent reply. Perch Pro adds the full conversation, live updates and replying from your phone. Needs the latest Perch for iPhone.

Changed

  • Settings now explains what Perch Pro adds, and links to Perch on the App Store.
  • Diagnostics include a short log of "jump to terminal" clicks, to help find out why a click didn't land on the right tab.

0.5.139

Added

  • Stop and reply to Amp from your phone and watch. Perch now talks to Amp directly, so Stop works and replies arrive even mid-turn. Restart Amp once after updating.
  • Amp conversations on your phone. Tap an Amp session to read it and watch new messages arrive.
  • Amp cloud threads on the list. Threads Amp runs in the cloud show up beside your local ones.

Changed

  • An Amp "finished" notification now shows the start of Amp's reply.

0.5.138

Added

  • Cursor and Antigravity conversations on your phone. Tap one of their sessions on your iPhone to read its history.

Fixed

  • Long Amp turns no longer drop off the list after ten minutes, and the row shows what Amp is doing instead of just "Working".

0.5.137

Added

  • Droid and Devin conversations on your phone. Tap a Droid or Devin session on your iPhone to read its history (your prompts, the agent's replies and the tools it ran) and see new messages as they arrive. A Devin conversation picks up where Devin compacted it, so earlier work stays in view.
  • Groundwork for the next iPhone update.

0.5.136

Added

  • Muse: approve, reply and stop from Perch. With Muse set to "Ask me", its approval requests now come to your phone, watch and Mac, and you can answer them there. You can also reply to a Muse session or stop it from your phone or a Mac notification. Perch won't type into Muse while it's showing you a question or an approval, or while it has put a stopped prompt back in its input box.
  • Muse in Stats. Turns, tokens, model and active time for Muse sessions now appear in Stats.
  • Muse sessions show Muse's own icon on the Mac.
  • Groundwork for the next iPhone update.

Changed

  • Muse approvals with no phone nearby go back to the terminal after 10 seconds instead of 45, because Muse's screen stays blank while Perch holds the request.

0.5.135

Changed

  • Rate-limited sessions are shown in yellow and say "Rate limited".

Added

  • The dropdown notes when an agent's turns keep failing on server errors.
  • Groundwork for the next iPhone update.

0.5.134

Added

  • Rex: Perch now tells you when Rex's Remote Control setting is needed to jump to the right session.
  • Groundwork for the next iPhone update.

0.5.133

Fixed

  • Your phone's Live Activity catches up sooner after you answer on the Mac. When an agent stopped needing you, the Live Activity on your iPhone could keep saying it did, because a quick run of updates was dropped instead of sent once things settled. Perch now sends the last update when the quiet period ends, and sends it at full priority when a wait has just ended.

Added

  • Groundwork for the next iPhone and Watch update. Perch now tells your phone how many background tasks a Claude Code session has running, and when a "needs you" alert has been answered on the Mac so the phone can clear it. You'll see both once the matching iPhone app update is out.

0.5.132

Fixed

  • No more idle OpenCode sessions you never started. Some apps open OpenCode sessions in the background just to check that it works (OpenBot does this each time it launches), and each one showed up in Perch as an idle session. Perch now lists a newer-style OpenCode session from its first prompt rather than the moment it's created. A freshly opened OpenCode window appears once you send it something.

0.5.131

Added

  • See when an agent's service is having an outage. Perch now reads the official status page of Claude Code, Codex, Amp, Devin (Windsurf's) and Droid. When the part your agent uses is down, a red banner in the dropdown says so and links to the incident. Lesser trouble (a slowdown, maintenance, an incident that's being watched) shows as a small icon next to the agent's usage, and every problem is listed in Settings → General → Integrations. Only pages for agents you use here are read, never while your Mac sleeps. Turn it off with defaults write com.inkryptislabs.perch perch.providerStatus -bool false.
  • See when an agent CLI has an update. Settings → General → Integrations shows the version of Claude Code, Codex, Amp, Droid and OpenCode, and when a newer one is out on the channel you installed it from, how to update there (for example brew upgrade opencode). A small dot on the gear in the dropdown tells you there's something to look at. Perch never installs anything. Tools that update themselves are only flagged once a release has been out for a day. Checked once a day; turn it off with defaults write com.inkryptislabs.perch perch.agentUpdateCheck -bool false.

0.5.130

Fixed

  • Droid approvals reach your iPhone again. With some models (GPT-6.1 Sol among them), Droid 0.249 runs its tools from a script, and Perch couldn't tell which command it was asking about, so every approval had to be answered in the terminal. Perch now reads the command from Droid's script, and Allow still only goes once the dialog on screen shows that same command. A script it can't read is still left for the terminal.
  • No Reply at Claude's multiple-choice questions. A reply sent there was dropped, and Claude took whichever option was highlighted, so "Purple" could answer "Red". Perch no longer offers Reply on your iPhone or in the Mac notification for these questions. Answer them in Perch's question sheet, or in the terminal. Replying when a usage limit has reset ("press Enter to continue") still works.

0.5.129

Fixed

  • A paired device can't put a fake approval on your Mac. A device holding Perch's pairing secret could make an approval appear on your Mac, naming any project and command, and have it passed on to your other devices. Approvals now come only from your agents. Answering such a request never approved a real tool.
  • Droid: no Allow from Perch for a long command. For a command over 60 characters or more than one line, Perch saw only its start, so Allow could have approved a different command that began the same way. Perch no longer offers it; answer it in the terminal.
  • No Reply or Stop for agents that can't take one. Perch misread some command-line options, so a few runs with no prompt looked like sessions you could reply to: Cursor's worker started with --resume or -w, OpenCode's serve started with --auto, Amp started with --execute=…, and Claude Code or Devin started with an option Perch didn't recognise. Perch now reads each agent's options the way that agent does, and holds back Reply when it meets one it doesn't know.
  • Amp: replies wait while you switch threads. Mid-switch, Perch holds a reply instead of guessing which thread is open, and both threads stay on the list.

0.5.128

Added

  • Perch works with Rex. For agents running in Rex, Superlogical's terminal:
    • Jump to the agent. Clicking a session brings Rex to the front and focuses the agent's pane. To have Rex switch to that session as well, turn on Remote Control in Rex's Settings, under Rex Server.
    • Reply from your iPhone. Your message goes into the agent's own pane, even when another pane or session is in front.
    • Stop from your iPhone, for Claude Code, Codex, Antigravity and Droid.
    • No reply or Stop while a prompt is up. While the agent shows an approval or a question, answer that first, with Allow or Deny or at the Mac. Perch won't send a message or Stop then, because either one would answer the prompt for you.
    • No Reply field on Mac notifications for sessions in Rex yet.

Fixed

  • A resumed session opens in the right terminal. A session started in one terminal and resumed in another could bring the first terminal to the front when you clicked it.

0.5.127

Improved

  • Approvals show the whole command. Your Mac notification, iPhone and Apple Watch used to show only the first line of a command, cut at 60 characters, so a command with several lines looked like just its first. Now the full command is sent for Claude Code, Codex and Devin, up to 4 KB. Hidden characters that could disguise a command are shown as codes. The iPhone and Apple Watch show the full command after their next update.
  • No one-tap Allow on a command your notification can't show in full. When a command is longer than a notification can show, the Mac notification offers Deny and "Review in terminal" instead of Allow, and the iPhone lock screen opens the full request in the app instead of offering Allow.

0.5.126

Added

  • Approve or deny Devin's requests from your iPhone, Apple Watch or Mac. When Devin asks permission to run a command, Perch shows the request the way it does for Claude Code and Codex, and your answer goes back to Devin. If you don't answer in time, Devin shows its own dialog as before. While approvals are on, Devin waits up to 45 seconds for your answer before it shows that dialog.
  • Reply to and stop Codex sessions from your iPhone, in Codex's default mode. Since Codex 0.157 a session runs in Codex's background service, and until now those rows said replies and Stop weren't available. Perch now reaches the session through that service. Stop also works while Codex is writing its answer, which pressing Escape didn't.

Improved

  • Storage finds more of your projects. Worktrees and build folders now show for projects you worked on with Cursor, Devin, Droid, Muse or Antigravity, not only Claude Code and Codex.

Fixed

  • Cursor: stopping a turn no longer says it finished. A turn you cancel with Ctrl+C now reads "Interrupted", with no finished alert.
  • Cursor: live status works if you've moved Cursor's config folder. With CURSOR_CONFIG_DIR set, Perch's hooks were installed where Cursor never read them. Perch also finds Cursor's chats under XDG_CONFIG_HOME.

0.5.125

Fixed

  • Messages sent to Devin from your iPhone now arrive. Devin often missed the Enter that Perch pressed right after pasting the message. The text sat in Devin's input box, unsent, while your phone said it was sent. Perch now waits half a second before pressing Enter.
  • Antigravity sessions stay on the list after agy updates itself. When Antigravity updated while a session was running, Perch stopped recognising that session. It dropped off the list, with no replies or Stop from your phone, until you restarted it. Perch now keeps following it, including after the old version's file is cleaned up.

0.5.124

Added

  • OpenCode Go: real usage bars. Perch now shows OpenCode's own numbers for your Go plan: the 5-hour, weekly and monthly windows and when each resets. Before, the bars were an estimate from this Mac's sessions, and could show a quarter of your real usage on models with lower limits. If you've signed in to OpenCode Go in OpenCode, it just works. Otherwise paste your Go API key in Settings → General → Usage. The key stays in your Keychain and is sent only to opencode.ai. Without a key, the bars stay an estimate, and Settings says why.

Improved

  • The fleet window opens faster with many sessions. It now builds only the rows on screen.

0.5.123

Added

  • Storage → Build output: see which build and dependency folders take your disk space. Perch lists them in the projects your agents work in: node_modules, Swift's .build, Rust's target, Xcode's build, web builds, and Xcode's DerivedData. Each shows its size and when the project was last used. Perch only lists a folder git ignores and whose project file sits beside it, so release output and hand-made folders stay off the list. It warns when a folder holds an Xcode archive or an installer, which can't simply be rebuilt. Perch doesn't delete anything: Show in Finder opens the folder so you can remove it yourself.

Fixed

  • Storage sizes no longer count hard-linked files twice. Rust target folders read about half again too large.

0.5.122

Added

  • Storage, a new Settings pane for getting disk space back from git worktrees. It lists every worktree in the repositories your agents work in, including ones you made by hand. For each one it shows its size, when it was last used, which agent made it, and what you'd lose: uncommitted files, commits that are on no branch, and commits that were never pushed.
  • Move a worktree to the Trash from the Storage pane. Perch checks first and won't move one that's locked, that a session or an open editor is using, or that holds work it can't account for. Commits that are on no branch are saved to a perch/saved/ branch before the move. You can put it back from the Trash until you empty it.
  • Clear git's leftover records for worktrees whose folder is already gone. Each record goes to the Trash, and Perch won't clear one that still holds commits on no branch.

Fixed

  • Claude Code: a session you named shows that name even when it runs without Perch's hooks.

0.5.121

Fixed

  • Regenerating the pairing code or turning iPhone alerts off now also stops a notification Perch was about to retry. When the push service was briefly busy or the network dropped, Perch tried again a few seconds later — and that retry still went to a phone you had just unpaired or switched off. Now every retry checks first, and push.log says why one was cancelled.

0.5.120

Fixed

  • Codex: replies and Stop need proof that Perch's hooks run in that session. Once a Codex session has run a turn, Perch now waits for a hook event from that session before it will type into it. A session started with a --profile that turns hooks off, or started before Perch's hooks were installed, shows "hooks unconfirmed" instead of offering a reply that could land on an approval prompt Perch can't see. Codex sessions running in Codex's background service can take replies through herdr again.
  • Regenerating the pairing code, or turning the companion off, now cancels messages and Stops the phone had already sent. Before, anything still waiting to be typed went into the terminal anyway.
  • Codex: codex -- exec is recognised as an interactive session. A word after -- is the first message, not a command.

0.5.119

Fixed

  • Claude Code: a reply can no longer approve a permission prompt Perch had stopped showing. When Claude ran tools in parallel, or a background subagent asked for permission, Perch could read the session as running or idle while the approval dialog was still open — and a reply sent from the phone or a notification then pressed Enter on the dialog's Yes. The session now reads "needs you" until that exact dialog is answered, and replies and Stop stay off until then. A background subagent's question for permission now shows as "needs you" for as long as it is open.
  • Codex: a project that turns hooks off is recognised. If a project's own .codex/config.toml sets [features] hooks = false, Perch can't see Codex's approval prompts there, so the row now says "hooks off in .codex/config.toml" and offers no replies or Stop.

0.5.118

Fixed

  • Perch no longer removes hooks of yours that only mention it. A hook or status line counted as Perch's whenever its command contained the name of one of Perch's helpers — so something like check-policy --log /tmp/perch-report.log was deleted when Perch updated its hooks, on Remove Integration, and by the uninstaller. Perch now claims only commands in the exact shape it writes, and leaves everything else alone.
  • Codex: Stop is offered only when Perch can see Codex's approval prompts. Pressing Escape at a Codex approval prompt denies it, so Stop needs proof that Perch's approval hook is installed, switched on and trusted in Codex. Perch now asks Codex itself, re-checks whenever Codex's hook or config files change, and keeps Stop off until Codex confirms — usually about a second.
  • Codex: replies get the same check. A reply typed into a Codex approval prompt approves the command, so replies to Codex sessions now also wait for Codex to confirm Perch's approval hook. A Codex session started with --disable hooks or -c features.hooks=false shows "no hooks" and offers no replies or Stop. Codex sessions in Codex's background service no longer take replies through herdr either; start Codex with --no-daemon to get them.

0.5.117

Added

  • Muse Code, Meta's coding agent, now shows up in Perch. Every open muse terminal gets a row — working, finished, interrupted or closed — with the first thing you asked as its title, and a "finished" notification carrying Muse's closing reply. A new folder waiting on Muse's "Do you trust this workspace?" question shows as "Waiting for you to trust this folder". Perch adds its hooks to ~/.config/muse/settings.json beside your own, and Remove Integration takes them out again. Replying, Stop and approvals for Muse come in a later update; the iPhone and Watch show Muse sessions once the companion app is updated.

0.5.116

Fixed

  • Amp: Perch's plugin now actually reports to Perch. Its messages were being dropped, so Amp sessions only appeared from Perch reading Amp's thread history — and a session waiting for your approval never showed as needing you. The same fix applies to OpenCode 1.x.
  • Claude Code: Stats read faster with Claude Code 2.1.300, which writes large new records into its transcripts that Perch now skips.

0.5.115

Fixed

  • Codex: sessions no longer disappear after 30 minutes idle. Since Codex 0.157, sessions run in Codex's background service by default, and Perch dropped an idle one from the list after half an hour even with its terminal still open. It now stays as long as the session is open.
  • Codex: the phone says why it can't reply to a session in Codex's background service, instead of suggesting tmux. Start Codex with --no-daemon to get replies and Stop back while Perch learns the new setup.

0.5.114

Added

  • Antigravity: a session waiting for you to trust its folder now shows up. The Antigravity CLI asks "Do you trust the contents of this project?" the first time you open it somewhere new, and until you answered, the session was missing from Perch. It now reads "Waiting for you to trust this folder".

Fixed

  • Devin: a session you quit now leaves the list right away, instead of lingering until Perch noticed the process was gone. Resuming a session you just quit keeps it on the list.

0.5.113

Added

  • Cursor: sessions started with agent persist now show up. Cursor keeps these running in the background after you close the terminal, and Perch missed them entirely. They now get a row, whether a terminal is attached or not, and you can reply to one from your phone even while it's detached.
  • Cursor: a session waiting for you to trust its folder now shows up. Cursor asks "Do you trust the contents of this directory?" the first time you open it somewhere new. Until you answered, the session was missing from Perch. It now reads "Waiting for you to trust this folder".

Fixed

  • Cursor: Stats, the last reply and the conversation now work for every project folder. For a folder whose path has an underscore, a dot, a space or a double dash, Perch looked for Cursor's transcript in the wrong place and found nothing. Stats recounts your Cursor history once after updating.

0.5.112

Added

  • Droid: Allow or Deny a permission from your phone, watch or Mac notification. For a Droid session running in tmux, a command or file edit that needs your OK now comes with Allow and Deny buttons, like Claude's. Before pressing anything, Perch checks the terminal: the dialog must still be up, with the same command or file you were shown. If it isn't, nothing is pressed and the prompt stays for you at the terminal. Two tools at once, and "always allow", are left to the terminal.
  • Droid edits made with patches now show the file name on the row.

Fixed

  • A session waiting on a permission always gets a Mac alert now. With approval notifications on, Perch skipped the "needs you" alert and expected an Allow/Deny one instead. For Amp, Antigravity, Cursor, Devin and Droid outside tmux no Allow/Deny one ever came, so there was no alert at all. They now get "needs you", and the agents that do get Allow/Deny don't get both.

0.5.111

Added

  • Droid: reply and Stop from your phone, watch and Mac. For a Droid session running in tmux, you can now type a message to it and stop a turn that's working. Perch checks which session the Droid terminal is in right now before sending anything, so a message never lands in a conversation you've switched away from with /new, /clear or /sessions. Stop is only offered while Droid is working. Neither is offered while Droid is waiting on a permission or a question, so a reply can't approve something by accident. If Perch's Droid hooks are off, both stay off and the row says why.
  • Droid in Stats. Tokens, models, active time and prompts per day for your Droid sessions, with a Droid filter alongside the other agents.

Fixed

  • Droid subagents no longer show up as sessions of their own. Each one appeared as an extra row that read "finished", with a chime. A subagent now counts as part of the session that started it, and when it needs a permission, that session shows as waiting for you.
  • A Droid question shows as waiting the moment it appears, about a second sooner than before.

0.5.110

Fixed

  • Droid: a session waiting for you to trust its folder now shows up. Droid asks "Trust this folder?" the first time you open it somewhere new, and until you answered, the session was missing from Perch. It now reads "Waiting for you to trust this folder", and becomes a normal row once you accept. A folder inside one you already trust doesn't ask, and Perch knows that too.
  • The message on your phone for a session waiting on folder trust now names the right agent. It said "Claude" for every session.

0.5.109

Changed

  • Droid: a question shows on the row. When Droid asks you something, the row and the "needs you" alert now show the question ("Question: Red or blue?") instead of "Factory CLI is asking the user 1 question(s)".
  • Droid: the "finished" notification says what Droid replied, when the turn ended with a reply. A turn that ended on a command or tool still gets the plain "Droid finished its turn."

Fixed

  • Uninstalling with scripts/uninstall.sh puts your own Antigravity status line back exactly as it was, including one you had turned off. If it can't be restored, the saved copy is kept and the script tells you where. Its backups of your settings are now private to you.

0.5.108

Added

  • Factory's Droid CLI. Perch now shows your droid sessions on the Mac:
    • which ones are working, with the tool and how long the turn has run, which need you for a permission, and which have finished;
    • the model, effort and context used, and jump-to-terminal for each.

Perch adds its hooks and a small status line to Droid's settings, next to any hooks you already have. If you had your own status line, it still shows, and it's put back if you remove Perch. droid exec runs are not shown. Droid rows on the iPhone and Apple Watch come with the next app update.

Fixed

  • Amp: sessions started with --executor, --attach, --title, --runner-dir or --project can be replied to again. Perch read the option's value as a command and treated the session as one it couldn't type into.

0.5.107

Changed

  • Claude: MCP tools are named readably. A permission request for an MCP tool used to read like mcp__github__create_pull_request, on the row, the Mac notification, your phone and your watch. It now reads github - create_pull_request (MCP), close to what Claude shows in the terminal. The "don't ask again" button says the same. Phones on the current app see it too.

Fixed

  • Claude: claude purge no longer shows up as a session. Claude Code 2.1.288 added the command, and Perch mistook it for a running session.

0.5.106

Fixed

  • Claude: a session without Perch's hooks keeps its own row. If another Claude run finished in the same folder, such as claude -p, the live session's row could switch to that finished run. A session waiting on you then stopped showing as needing you. Two such sessions in one folder could also show as one. Perch now goes by Claude's own record of which session each process runs, when the session's transcript confirms it. This also covers a --resume session after /clear.

0.5.105

Added

  • Claude: a row tells you when your next message will cost more. Claude keeps your conversation cached for about an hour. Once a session has sat that long, idle or waiting on you, the cache is gone, and your next message pays to rebuild it. The row now says so: "cache cold · 39k to rebuild".
  • Claude: sessions in fast mode say "fast" next to the model.

0.5.104

Added

  • Answer OpenCode 2 sessions from Perch. Until now Perch could show that an OpenCode 2 session needed you, but not let you answer. Now you can:
    • Allow, Deny, or "Allow and don't ask again" a permission, from the Mac notification, the phone or the watch. "Don't ask again" saves OpenCode's own rule for the project, the same one OpenCode would save, and the button says which.
    • Answer a question from the phone when it offers choices, or from the Mac's notification when it asks for one line of text. A question Perch can't answer exactly stays in OpenCode.
    • Reply to a session that's idle or working, and Stop one that's working.

Every answer goes only to the OpenCode server on this Mac, and only if it is still the server the question came from.

  • Claude: a model change shows straight away, including one Claude makes by itself.
  • Claude: an MCP server asking for input shows as needing you straight away, instead of after a few quiet seconds. Perch doesn't offer a reply for these, because a typed reply could submit the server's form.
  • Claude: a session in a folder you haven't trusted yet says so. Claude runs no hooks there until you accept its trust prompt, so the row used to look broken. It now reads "Waiting for you to trust this folder", and becomes a normal row as soon as you accept.

Fixed

  • OpenCode Stats and the Go usage estimate count OpenCode 2. After upgrading, they stopped at the upgrade date, and a fresh OpenCode 2 Mac showed nothing. Your history from before the upgrade is counted once, not twice. On a Mac running both OpenCode 1 and 2, sessions no longer appear and disappear depending on which one ran last.
  • OpenCode 2: an answered prompt no longer comes back. One answered while Perch's connection had dropped for a moment could show as needing you again later.
  • Claude -p runs: approvals say what happens if nobody answers. In a run with no terminal prompt to fall back to, Claude denies the tool when no answer comes. The Mac notification now says so, and the row stops showing "needs you" afterwards. The phone and watch get the same wording in the next iOS update.
  • Claude: Perch won't type into the wrong conversation. When a session runs without Perch's hooks, Perch guesses which conversation it is. If Claude's own record of that session disagrees, Perch now offers no reply instead of one that could land in another session.
  • Claude background sessions say how to open them. A running background session was told to "run in tmux or herdr", which can't help. It now says to open it with claude attach.

0.5.103

Fixed

  • OpenCode works when its folders are moved in your shell's startup file. If your .zshrc or .zprofile sets XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_STATE_HOME, OPENCODE_CONFIG_DIR, OPENCODE_DATA_DIR or OPENCODE_DB, OpenCode used those folders but Perch didn't know. So Perch's plugin could be installed where OpenCode never looks, its sessions database could go unfound, and OpenCode 2 sessions could be missing entirely. Perch now asks your login shell for those six settings once at launch, and only those. Anything your startup file prints is ignored. A setting given for one terminal session only, such as XDG_DATA_HOME=… opencode, still isn't seen.

0.5.102

Added

  • OpenCode v2 sessions are back on the fleet. OpenCode 2 keeps every session in one background server, and Perch could not see them. Perch now follows that server directly, so every v2 session shows live on the Mac and the phone: working, idle, or needing you. That covers sessions from the terminal, the Desktop app and the web. When a session needs you, the row shows what it waits on: the command it wants to run, or the titles of the questions it asks. Cost, tokens, the model and plan mode show as they do for OpenCode 1. Answering a v2 prompt from Perch, and jumping to its window, come later; for now, answer in OpenCode. Nothing needs installing or restarting.
  • Claude rows show the session's name, and its pull request. A name set with /rename or --name, or the title Claude writes for a session, now becomes the row's title, even when it changes mid-session. If the branch has an open pull request, the row says so with its review state, for example "PR #1234 approved" or "PR #12 changes requested". The badge goes away when the pull request is merged or closed. Both come from the status line Perch sets up for Claude Code.

Fixed

  • A Claude session running without Perch's hooks shows working while it works. Such a session, for example one started with --bare, read idle for its whole turn. It now shows working, with the time since the turn began. Stopping it with Esc does not send a "finished" alert.
  • Perch's OpenCode plugin loads in OpenCode 2. OpenCode 2 reported it as a plugin that failed to load. It now loads cleanly in both versions.
  • No frozen OpenCode session after upgrading to OpenCode 2. OpenCode 2 stops writing the sessions OpenCode 1 kept, and Perch went on showing the last of those as if it were current.

Changed

  • Perch does less work while you're not looking at it. The fleet window and Settings stop drawing while they are closed, hidden, minimised or on another desktop. Rows redraw only when something they show changes, and their spinners and timers animate without waking Perch every second.
  • The working spinner on a row is a turning arc instead of the system's spoked spinner. Past an hour, a row's timer reads 1:02:05 instead of 62:05. With Reduce Motion on, rows hold still.

0.5.101

Added

  • "Allow and don't ask again" from the Mac's permission notification. When Claude Code asks permission and suggests a rule, the notification now has a third choice next to Allow and Deny: allow this, and save the rule so Claude stops asking. The notification says which rule and where it will be saved, for example "Bash(sw_vers) in this project", and it is exactly the rule the terminal's own "don't ask again" option would save, nowhere wider. The choice appears only when Claude offers a rule. Some requests offer none, such as a command that writes files, where Claude suggests a mode switch instead; those keep Allow and Deny only. On a Mac managed by an organisation that locks permission rules, the choice is not offered. The permission audit log records every rule saved. The phone and watch get the same button in the next iOS update.

Fixed

  • Two release checks that could fail on a busy Mac. They were tests with a timing assumption, not a fault in Perch.

0.5.100

Fixed

  • Every Claude background session is recognised, not only some. Claude runs a background session in one of three ways, and Perch knew one. A session that started before Claude had a spare slot ready, or one Claude restarted after a crash, was not seen as Claude at all. With Perch's hooks it kept its row but lost track of its process: after a restart the row went on pointing at the process that had died. Without hooks it had no row. Perch now recognises all three, so the row follows the session across a restart and carries its claude attach command either way.
  • A session opened with claude --resume=<id> or claude -r<id> is matched to the right conversation. Perch read the session only from the spaced form, --resume <id>, and could also mistake the word --resume inside a prompt for the option.

0.5.99

Added

  • A Claude background session that is blocked and no longer running shows up in Perch. A background session can ask for something and then have its process exit, for example after a restart of the Mac. It stays "blocked" in Claude until someone opens it, but it has no process and sends no events, so Perch never showed it. Perch now asks Claude for its own list of sessions, about once a minute, and shows each such session as needing you, with the command that opens it, for example claude attach 6c4635ce. There is nothing to reply to or approve from Perch for these; the session has to be opened. A session that was already blocked when Perch started appears quietly. One that becomes blocked while Perch is running sends the usual alert, once. These sessions do not keep the Live Activity card on your phone open. Perch only asks Claude when a background session exists, and it looks for claude in ~/.local/bin, /opt/homebrew/bin and /usr/local/bin.

0.5.98

Fixed

  • Perch notices a Claude session waiting at a prompt even when its hooks are not running. Until now everything Perch knew about a Claude session came from its hooks. A session started without them, or one stopped at a prompt the hooks do not report, such as a sandbox request or an open dialog, looked idle or did not appear at all. Perch now also reads the status Claude Code keeps for each running session, so such a session shows as needing you, says what it is waiting on, and sends the usual alert. These prompts can only be answered at the terminal, or with claude attach for a background session, so there are no Allow and Deny buttons for them.

0.5.97

Fixed

  • Claude background sessions are tracked as themselves, and their rows say how to open them. A session started with claude --bg, /bg or from Claude's agent view has no terminal window. Perch tied every such session to Claude's shared background service instead of to the session's own process, and its row looked like any other. The row now reads "background" and shows the command that opens it, for example claude attach 51a28312. That matters when a background session is waiting on a permission prompt: Perch offers Allow and Deny for 45 seconds, and after that the only way to answer is to attach.

0.5.96

Fixed

  • A Claude session started without Perch's hooks now says so, and cannot be replied to or stopped remotely. Starting Claude Code with --bare, --restricted, or --setting-sources without user skips the settings file Perch's hooks live in. Perch showed such a session as an ordinary row that never changed, and it could not tell when the session was sitting at a permission prompt, where a reply approves the command and Stop denies it. The row now reads "no hooks" with the flag that caused it, and replies and Stop are refused for it. Start the session without that flag to get live state and replies back.

0.5.95

Added

  • Each Claude session shows its permission mode. The line under a session's name now says "auto", "manual", "plan", "accept edits" or "bypass", next to the model and context. Claude Code now starts in auto mode unless you choose otherwise, and in auto mode it rarely stops to ask for approval, so a session that never needs you is no longer a mystery. The iPhone shows the same with its next update.

Fixed

  • A Claude session waiting for you after a usage limit now says so. If your limit reset while the Mac was asleep, Claude Code waits for you to press Enter before it carries on, and Perch showed the session as idle. It now shows as needing you. A session that resumed on its own goes back to running, and one that gave up waiting says why.

0.5.94

Fixed

  • Claude sessions in folders with an underscore, a space or other special characters now show their details. Perch looked for such a session's transcript under the wrong name, so its row had no model, no context percentage, and a clock stuck at the time it started. Perch now names the folder the way Claude Code does, and finds very long paths by the session's own id.
  • Claude's background helpers no longer appear as sessions. claude daemon, claude rc and claude self-hosted-runner are tools, not conversations, and each used to show up as a row that did nothing.

0.5.93

Fixed

  • A reply can no longer approve a permission prompt by accident. If a session was waiting on a permission prompt and you sent it a reply, from your iPhone or from a Mac notification, the agent's dialog ignored your text and took the Enter as "Yes". The command ran whatever you had typed, including "no, don't do that". Perch now refuses to send a reply while a session is waiting on a permission prompt. Use Allow or Deny, or answer at the terminal. Replies to a session that is asking you a question work as before. No iPhone update is needed: updating the Mac is enough.

0.5.92

Fixed

  • Lock-screen cards are no longer started on phones that have gone quiet. Perch could start a Live Activity on an iPhone it had not heard from in up to two weeks, such as an old install or a test device. iOS allows only a handful of these starts, so the wasted ones could leave your real phone without a card. Perch now starts a card only on a phone it has seen in the last two days, or one that is connected right now. Alerts still reach a phone that has been away for up to two weeks.

0.5.91

Fixed

  • Stats builds its history about six times faster. The first time Stats opens, and again whenever an update changes how it counts, Perch reads every transcript on your Mac. It used to read them one at a time; it now reads several at once. Measured on one Mac with 1,600 files: 47 seconds down to 8. The numbers are unchanged. The progress count moves quickly and then pauses near the end while the largest transcripts finish — that is expected.

0.5.90

Fixed

  • Subagents that never really existed no longer linger under a session. After a large fan-out, a few rows could stay under the session as "running" long after every agent had finished, until the session ended. Perch now removes a subagent row once it has no record of its own on disk and has been silent for three minutes. Agents that are really working are not affected, however long a single step takes.

0.5.89

Fixed

  • Perch stays responsive while many subagents run. With a dozen background agents working, Perch re-checked each agent's files every time it refreshed the list. That work now happens in the background, so each refresh takes about half as long.
  • Jumping to a terminal can no longer freeze the menu bar. Clicking a session that lives in Terminal, iTerm2 or Ghostty used to wait on that terminal with the menu bar frozen, for up to two minutes if the terminal was busy or macOS was showing its "Perch wants to control…" prompt. The jump now happens in the background, gives up after five seconds on a terminal that doesn't answer, and quick clicks are handled in order.
  • A reply typed from a notification always lands in the right pane. Clicking another pane of the same terminal just as a reply was being typed could send it to the wrong session.

0.5.88

Fixed

  • Stats opens fast again for OpenCode users who delete sessions. After any OpenCode session was deleted, Stats re-read your whole OpenCode history every time it opened (and every time your phone asked for stats), which on a large history took several seconds. It now reads once and goes back to using its saved results.
  • The "Exact cost" card says whose cost it is. Only OpenCode reports a cost, but under "All" the card looked like your total spend. On the Mac it now says "OpenCode only"; on your iPhone it shows under the OpenCode filter.
  • A question from Claude is no longer occasionally missed. When Claude asked you a question at the same moment as other activity in the session, the "needs you" state could be overwritten. Several sessions updating their cost or usage at once could also drop one session's numbers until its next update.
  • The privacy notes describe usage checks accurately. The README now says Anthropic and ChatGPT usage is also checked every 15 minutes while you're idle (if you used that agent here in the past week), lists Amp, and links to how to turn each one off.

0.5.87

Added

  • Second Claude accounts. If you run Claude Code with a separate config folder (for example CLAUDE_CONFIG_DIR=~/.claude-work for a work account), add that folder in Settings → Claude config folders. Perch installs its hooks there too, shows those sessions, and keeps that account's usage separate. Perch suggests folders that look like Claude's, and writes nothing to a folder until you add it.

Fixed

  • Forked OpenCode sessions show up as themselves. Starting OpenCode with --fork showed the original session as the live one, and the new fork had no row. It now shows the fork.

0.5.86

Fixed

  • The lock-screen countdown no longer restarts while an agent waits for you. When other parts of a session kept working while one part waited for approval, the "time to answer" on your iPhone's Live Activity kept jumping back up, and could still show time left after the request had timed out. It now counts from when the wait began.
  • A lock-screen card that can't be updated no longer lingers. A Live Activity that Perch started while the iPhone app was closed could keep showing "needs you" for up to an hour after you'd answered. It now fades after ten minutes if Perch can't reach it.

0.5.85

Changed

  • The menu-bar thinking word changes every 10 seconds instead of every 3. Each change made macOS redraw the menu bar, and while an agent was working that redraw was most of the work Perch did. The word still rotates, just more calmly.

Improved

  • Perch uses less CPU in the background. Looking up which agents are running used to re-read every process on the Mac every four seconds. It now remembers what it has already read and only looks again when a process changes, which makes each check about nine times faster.

0.5.84

Fixed

  • Amp stops saying "Approval required" once you've approved. After an approval, the row kept asking while Amp got on with the work. It now reads "Working".
  • Antigravity's finished alert is no longer lost. A status update that arrived just after a turn ended could mark it as running again, so the finished alert never came. The turn now stays done.
  • Cursor and Devin sessions show their conversation title again. With hooks installed, an idle row read "Idle" instead of the title of the conversation.

0.5.83

Fixed

  • Claude no longer says "finished" while background work is still running. When Claude Code ended a turn with a background command or monitor still going, Perch announced it as finished straight away, and again when the work completed. The row now shows "1 background task" (or however many) and the finished alert waits until Claude is actually done.
  • An error is not a finish. When a Claude turn stopped on an error, such as a rate limit, a server error or being signed out, Perch announced it as "finished", and a rate limit got both alerts. The row now names the problem, and a rate limit sends only the rate-limit alert.

0.5.82

Fixed

  • An OpenCode subagent asking for permission now shows NEEDS YOU. When a subagent inside an OpenCode session stopped to ask for approval or ask a question, the session kept saying "running" and no alert reached your phone. It now shows NEEDS YOU and sends the alert, and stays that way until every waiting subagent has been answered.
  • Answering in OpenCode itself clears NEEDS YOU straight away. If Perch handed a permission prompt back to OpenCode and you answered it there, the session stayed at NEEDS YOU until the approved command finished. It now clears as soon as you answer. Restart any OpenCode session that was already open to pick this up.

0.5.81

Fixed

  • A running Codex session keeps showing what it's doing. With Codex hooks installed, the row's tool line (for example "exec: npm test") and its timer could disappear within a second of a tool starting, leaving a plain "Running" for the rest of a long command.
  • Codex no longer stays at NEEDS YOU after you answer a subagent in the terminal. When a Codex subagent asked for permission and you answered in Codex's own prompt, the session could stay marked as waiting on you while the subagent carried on. It now clears as soon as that subagent moves on or stops.
  • No more stray Codex rows from the Codex app. Codex Desktop runs short background threads of its own, and each could appear as an extra idle Codex row, sometimes labelled "/". Perch now leaves them out.

0.5.80

Fixed

  • Codex "finished" notifications say what it did again. Newer versions of Codex write their closing message somewhere Perch wasn't looking, so every Codex notification just said "Codex finished its turn." It now shows the first line of the reply, as it does for Claude Code.
  • Hitting your Codex usage limit is reported as a limit, not a finish. A Codex turn that stopped because you ran out of usage was announced as "finished". It now shows "Rate limited" and sends the rate-limit alert instead. A turn that stops on another error names the problem on the row.

0.5.79

Fixed

  • Your phone reconnects after the Mac's listener hiccups. If the connection your phone uses failed to start (most often right after regenerating the pairing QR code), it stayed down until you turned the companion off and on or restarted Perch. It now retries on its own, on the same port first.
  • An approval is never shown as "Allowed" when nothing received it. If the agent's hook process died while waiting (an interrupted run, a closed OpenCode session), Perch kept offering Allow/Deny and reported a tap as delivered while the agent sat at its own prompt. The request now clears as soon as the hook goes away, and the log says so.
  • A tap that arrives too late is told what happened. Answering from a phone notification after the request was already settled on the Mac or by the timeout now tells you it was already answered, instead of going silent.

0.5.78

Fixed

  • Settings kept in a dotfiles folder stay linked. If your ~/.claude/settings.json (or Codex, Cursor or Devin config) is a symlink into a dotfiles repo, Perch replaced the link with a plain file, so your dotfiles copy stopped receiving changes. Perch now writes through the link and leaves it in place.
  • Your own hooks next to Perch's are kept. A hook command you added in the same group as Perch's, in Claude Code or Devin, was deleted the next time Perch updated its hooks or you removed the integration. Only Perch's own entries are touched now.
  • Perch works from a folder with a space in its name. With the app at a path like "Perch 2.app", every hook and the Claude status line failed and sessions showed "Hooks not firing".
  • The status line keeps working after you move Perch. Opening Perch first from the disk image or Downloads and then moving it to Applications left Claude's status line pointing at the old location, and usage, cost and context went blank.

0.5.77

Fixed

  • Codex sessions with hooks installed show their full details again. A Codex session that Perch hears about through its hooks lost the cost, context meter, effort level, task checklist and rate-limit warning that only Codex's own session file carries. Those rows now keep all of them.

0.5.76

Fixed

  • Codex costs use current prices. Perch's Codex price list was out of date, and a model it didn't know borrowed the price of an older one with a similar name. GPT-5.6 Sol, for example, was shown at about a third of its real cost, and GPT-6 Astra showed no cost at all. The list now matches OpenAI's published prices, including the GPT-6 and GPT-5.6 families.

Changed

  • A Codex cost that is incomplete says so. When some of a session's work was on a model with no published price, the figure now ends in "+" (at least this much), or shows "~$?" when none of it could be priced, instead of looking exact or free. GPT-5.3 Codex Spark and Codex's automatic review model have no published price, so sessions using them now show this.

0.5.75

Fixed

  • Your phone and watch stay paired when the Keychain is locked. If Perch couldn't read its pairing key — a locked keychain, or a Keychain prompt that was dismissed — it quietly made a new one, and every paired device stopped connecting with no explanation. It now waits and tries again, and Settings says what's wrong and how to fix it.
  • Codex spend is no longer overstated when you switch models. Changing model partway through a Codex session re-priced everything the session had already done at the new rate, and long turns could make it count the same work again. Each part of a session is now priced once, at the model that did it.

0.5.74

Fixed

  • Perch no longer grows to hundreds of megabytes while your agents work. Once the dropdown had been opened, it kept redrawing itself in the background even after it closed, and macOS kept every piece of text it drew. With a few agents running, memory climbed from about 30 MB past 200 MB in half an hour. The dropdown now does nothing while it is closed, so memory stays flat and Perch does less work on every update. It shows current data the moment you open it; the list no longer remembers how far you had scrolled.

0.5.73

Fixed

  • The dropdown no longer has an empty band above and below it. The window kept the height it was first given, often taller than what it showed, and the content sat in the middle of it. It now fits its content exactly and stays tucked under the menu bar as sessions come and go.
  • Usage bars show the newest reading. When both Claude's status line and the account fetch had a figure, the fetched one always won, even when it was several minutes older. The fresher of the two is now shown, and the "almost used up" warning follows it.
  • Stats count the work your agents' subagents do. Tokens spent by subagents — Codex's helper threads and Claude's sub-agents — were left out entirely, which on some Macs was most of the Codex total. They now count toward daily tokens and the model breakdown, and Codex cost includes them. They still don't count as extra sessions. Totals rise the first time you open Stats after updating.

0.5.72

Fixed

  • Phone alerts keep working when your Perch Pro subscription ends and you also own the $29 licence. Perch kept signing alerts with the Pro key after it lapsed, so every alert was turned away, and removing the key did not help: alerts to your phone stayed off for about a month. Perch now notices that a key has been refused, switches to a licence you hold that still works, and moves your phone's registration across. Nothing to do on your side.

0.5.71

Fixed

  • Approving from your phone attaches to the request the alert was about. With more than one request waiting, a tap on the alert could land on a different one. Perch now matches the request the alert named, and refuses rather than guesses when it cannot tell them apart.
  • Answering a Claude prompt at the terminal clears it everywhere. Choosing Yes in the terminal used to leave the request on your phone and the row showing "waiting" until it timed out. Perch now sees that the approved command is running and clears both. A decision that arrives after the turn has finished no longer brings a finished session back to "waiting".
  • Replying from a notification works inside tmux and herdr. The reply used to be typed into whichever pane was active, which could be the wrong one. It is now delivered to the session's own pane, the way messages from your phone are. If Perch cannot tell which pane that is, it brings the terminal forward instead of typing anywhere.
  • A phone with an old pairing code can no longer wear Perch down. Each refused connection held on to a system resource for good. After an hour or two of a stale phone retrying, Perch could stop receiving live updates from your agents, and permission requests would stall for close to a minute each. Refused connections are now released at once, and the local socket recovers on its own if the system ever does run short.

0.5.70

Fixed

  • Perch no longer risks a crash or a hang when its local socket server shuts down. A connection that had been accepted but not yet handled could outlive the server, which either tripped a system check when the server was released or left the shutdown waiting on the socket forever. Found by the release checks on macOS 27, where the timing surfaced it.

Changed

  • Phone connections now use forward secrecy. The link between your Mac and a paired phone or watch negotiates an ephemeral key on each connection, so a recording of past traffic on your network cannot be decrypted later even by someone who obtains the pairing secret. Nothing to re-pair: a phone running an older companion keeps connecting exactly as before, and picks up the stronger key exchange with its next update.

0.5.69

Fixed

  • Amp's plan name is back on the usage strip. Amp reworded its usage summary again and the "Megawatt" label silently disappeared. Perch reads the new wording, and from now on a usage fetch that returns fewer details than the one before it is written to the diagnostics bundle, so a change like this is visible instead of quiet.

Added

  • A session that is compacting its context says so. Compaction can take a few minutes with nothing else happening, and the row used to keep showing the last tool as if it were still running. It now reads "Compacting context…" until compaction finishes.
  • A tool that auto mode blocked is shown as blocked. When Claude Code's auto mode refuses a tool, the row now says which one, instead of keeping the previous tool's line up. Nothing to approve: auto mode already decided.
  • The diagnostics bundle lists your installed agent CLI versions next to the version each usage parser was last checked against, so a stale parser is a question with an answer.

0.5.68

Fixed

  • Opening Stats is fast again. Perch keeps a cache of every transcript it has already counted, but a file it read and found nothing to count in, such as a subagent's transcript, was never added to it, so it was read again on every open. On a Mac with a long history that was 16 seconds of scanning each time; now it is a fraction of a second. A file Perch could not read is retried rather than remembered as empty.

Added

  • Read a long message in full on your phone. A message or tool result the phone shows as truncated now offers "show the rest", and a tap fetches the whole thing from your Mac. Needs the next companion app update to appear; older phones keep the plain truncated note.

0.5.67

Added

  • Perch now tells you when a session needs a restart. An agent that was already running when Perch installed or updated its hooks never loads them, and until now such a session looked exactly like a healthy idle one. A Claude Code, Cursor or Devin session in that state now shows "Restart to enable live updates" on its row, and one that started after the install but has still sent nothing shows "Hooks not firing" instead, which is the case worth reporting. Settings lists, per provider, when the integration was installed, when it last sent an event, and how many open sessions need a restart. The diagnostics bundle carries the same lines.

0.5.66

Fixed

  • A phone you wiped or lost no longer keeps your terminal waiting. If a paired phone stopped connecting without being unpaired, Perch still held every unanswered approval for the phone's 45-second window for two weeks. Now a phone that has not connected in two days, or whose notifications Apple reports as undeliverable, still gets its pushes but no longer holds the terminal; the prompt appears there after the usual 22 seconds.

Added

  • Claude Code's newer hook events. Perch now listens for a tool failing (the session's activity line says so instead of showing the last tool), the working directory changing mid-session (the project label follows), and tasks being created or completed (the checklist updates at once instead of on the next event). Existing installs pick these up on the next launch; nothing changes on a Claude Code version that does not send them.

0.5.65

Improved

  • Claude Code's status line renders faster. Perch's status-line helper runs on every render, and it was spending about 20 ms per render searching a quarter-megabyte config file for your account and plan. It now reads the file once and finds both in under half a millisecond. What it shows is unchanged.
  • Perch's four-second scan can now be coalesced with other timers. The timer allows a second of slack so macOS can batch its wake with other work, which is what an idle Mac actually pays for a periodic check.

0.5.64

Fixed

  • A missed file event can no longer freeze a session's status until you relaunch. Hook-driven sessions reach Perch through a directory watch, and that watch was the only path. Every scan now also checks whether the directory changed and reloads if the watch missed it, so a stuck status is caught within a few seconds instead of never.
  • A stale "needs you" is no longer checked by reading the transcript on the interface thread. The check that clears a permission prompt Claude already answered elsewhere ran while Perch was drawing, and read up to 256 KB each time the transcript changed. It now runs alongside the scan, and a prompt raised again in the meantime keeps its "needs you" until the scan has looked.

Improved

  • Less work on an idle Mac. With no phone or watch connected, Perch no longer asks tmux, Herdr or OpenCode every four seconds whether each session can be typed into — nothing reads the answer until a companion connects, and the first one to connect triggers a fresh check. Two Claude sessions in the same repo also share one directory read per scan instead of two.
  • OpenCode sessions with long histories cost less per scan. Perch read every message in a session to find the newest one; it now asks the database for just that message when the session already carries its own totals.

0.5.63

Improved

  • Your phone and watch are no longer sent the same usage numbers twice every four seconds. The Mac republished account usage on every scan whether or not anything had changed, and every connected phone and watch decoded it each time. Usage now goes out only when a number actually moves, and the panel stops redrawing for a scan that found nothing new.
  • OpenCode Go usage no longer re-reads your whole OpenCode history while an agent is working. Every scan used to load and parse every message in the OpenCode database whenever it changed — which, with an agent streaming, was every scan. With a 250,000-message history that was five seconds and 685 MB each time, and it held up every other provider's scan behind it. Perch now asks the database only for the Go messages inside the current windows, and for the billing anchor once every five minutes: under half a second and about 20 MB at the same size. The numbers shown are unchanged.

0.5.62

Fixed

  • Jump-to-terminal works again on macOS 26. macOS 26 stopped letting Perch read another process's environment, which is where a session's terminal and pane used to come from. Every Amp session and every Antigravity session lost its terminal, and a click fell back to opening the folder. Perch now finds the terminal from the process tree instead, and for iTerm2 finds the exact pane from the session's tty. Warp's exact pane cannot be recovered this way; Warp sessions raise the app.
  • The phone can no longer type into a shell. claude -p, codex e, codex review, cursor-agent -fp and devin -cp are print modes with no prompt: text sent to their pane waits in the terminal and the shell runs it when they exit. Claude had no check at all, Codex missed the alias, and the others missed clustered flags. All are refused now, and so is an agent whose command line Perch cannot read.
  • Replying from a Mac notification checks the agent is still there. A reply left in Notification Center after the agent had exited was typed into whatever that terminal was showing — a shell, or a stranger's tab. Perch now re-checks the agent immediately before typing, and refuses under Zellij, where the reply would land in whichever pane happened to be focused.
  • A lapsed Pro key stays lapsed offline. When the licence server could not be reached, every key Perch held was treated as valid, with no expiry, so a revoked or expired Pro key came back on any network blip. Each key now remembers its own last answer, and an outage honours only that.
  • Perch never overwrites your hooks. A hooks block in ~/.claude/settings.json or ~/.codex/hooks.json with a shape Perch does not recognise used to be replaced wholesale with Perch's own entries. Perch now leaves the file alone and says why.
  • Usage meters tell the truth more often. Codex's context percentage no longer double-counts cached tokens. Amp's cycle no longer shows an invented 0% "reset" in the hours between midnight and the real renewal. An idle session replaying an old reading can no longer keep a fresher one out, and a real re-baseline from a live session takes effect at once. A malformed usage response can no longer crash the low-usage warning.
  • Codex sessions stop flickering to idle mid-turn. A scan that read no turn boundary, or read the previous turn's, could mark a running session idle for a tick — and hide it under "hide idle". Only a boundary written after the current turn began can do that now.
  • Cursor sessions stop firing "finished" mid-turn. A transcript read that landed on a half-written character counted as an empty transcript.
  • Stats no longer count Codex subagents as sessions.
  • Phone and watch approvals are honest. The Live Activity countdown is now the provider's real window (five minutes for OpenCode; none for Amp and Antigravity, which never time out). Needs companion app 1.0.7 or later for the rest: the watch no longer offers Allow/Deny for an agent question, and a tap on an unreachable Mac no longer closes the sheet as if it had been heard.

0.5.61

Fixed

  • Amp usage reads the new two-pool sentence. Amp reworded its usage summary when it split subscriptions into an agent pool and an orb pool, and Perch's Amp strip kept showing a stale reading (one account sat at "Other 99%" for two days while Amp itself said 26% used). The strip now shows the agent and orb pools by name, with the billing period's real end date.
  • A session that hit its usage limit no longer spins as "active". When a batch of background agents died on a rate limit, Claude Code never told Perch they had stopped, so the row kept a spinner and counted as active for up to thirty minutes after Claude was already back at its prompt. Perch now reads each agent's own transcript and drops the ones the API killed.

0.5.60

Added

  • Jump-to-terminal lands on the right Zellij pane. Clicking a session that runs inside Zellij now switches Zellij to the exact tab and pane hosting the agent — verified against the live process, so a finished session can never focus someone else's pane — and then raises the terminal as before. Perch also stops asking Terminal.app or Ghostty for Automation access it cannot use while a session is inside Zellij.

0.5.59

Added

  • Answer permissions from the iPhone notification. When an agent asks to run a tool, the phone alert now carries Allow and Deny buttons. Allow asks for Face ID / passcode first — approving a tool from a locked screen should cost that much — then the app opens, connects to your Mac, and delivers the decision, confirming on screen. If the Mac can't be reached or the window already closed, it says so plainly instead of pretending. Questions and plans keep the plain alert: those need reading, not a button. Needs the companion app 1.0.6 or later.

0.5.58

Added

  • Keep Mac awake while agents are active. A new opt-in in Settings → Sessions stops the Mac from dozing off mid-task: it holds off automatic system sleep while an agent is verifiably running, and through the approval window when one is waiting on you — so a permission can still be answered from your phone. It never fights the lid: closing it still sleeps the Mac. Off by default, and it releases the moment nothing is active.

Changed

  • Background alerts carry less. The "needs you" push used to include the question or command text twice — once in the visible alert and again in a hidden field no phone ever read — plus an unread provider field. Both hidden copies are gone; the push now carries exactly what the notification shows plus the two fields the app uses (event kind and project). What each push class contains is spelled out, class by class, in SECURITY.md.

0.5.57

Added

  • Jump-to-terminal lands on the right tmux pane. Clicking a session that runs inside tmux used to raise the right terminal app but leave the multiplexer on whatever window it was showing. Perch now tells the tmux server to select the agent's window and pane first — verified against the live process, so a recycled process id can never focus a stranger's pane — and then raises the terminal that actually hosts the tmux client, even though tmux masks it.

Fixed

  • Codex installed through asdf is found again. Current asdf (0.16 and later) writes shims that call asdf by name, which a Mac app's minimal environment cannot find — so an asdf-managed Codex silently didn't resolve, and Perch's Codex features stayed off. Perch now also puts asdf's own location on the path when probing a shim, for both asdf generations.

0.5.56

Fixed

  • The phone now says why a composer vanished. Kill an agent while its terminal pane stays open and the reply field on the iPhone disappears — as it must — but the screen said nothing about why. Perch now checks that the agent's process is really gone and tells the phone "The agent is no longer running here," in the moment you were most likely mid-reply. Sending was always refused in this state; only the explanation was missing.
  • Three rare crashes-in-waiting are gone. Moving the whole codebase to Swift 6's concurrency checking surfaced three long-standing data races — in the socket server's shutdown, the network listener's lifecycle, and the push retry path — all fixed. Nothing you see changes; the app is simply built to a stricter standard now.

0.5.55

Changed

  • A redesigned dropdown panel. Each session row now leads with a small provider · host · branch line in a monospaced type, with the project name as the row's big element — running and waiting sessions read at full strength while idle ones recede. The panel's header, list and footer sit on distinct tinted surfaces with hairline separators, the footer's Fleet-window and Quit actions are round icon buttons, and "needs you" uses one consistent amber across the row tint, chip and message. Styling only: what each row says, and what the panel costs to render, are unchanged.

Added

  • Light, Dark or System appearance. The panel (and every Perch window) can now be pinned light or dark independently of the Mac's setting — Appearance, in the panel's gear menu. Default: follow the system, as before.
  • Rows light up under the pointer. Session rows and the activity line show a faint highlight on hover, so what's clickable reads as clickable.
  • Stats got the panel's design. Metric cards are now tiles — a small uppercase label over a big figure on a faint surface — the numbers roll when you switch range or provider, and the window sits on the same background as the dropdown. Usage percentages and the header counts roll too, when a fresh reading arrives.

0.5.54

Changed

  • Usage bars stay fresh while you're away. Claude's and Codex's 5-hour and weekly figures used to freeze at the last status-line render when no session was running, so coming back after hours showed old numbers under a "may be stale" label. Perch now refreshes them every 15 minutes while idle — only for a provider you've used on this Mac in the last week, and never while the Mac sleeps — using the same read-only login it already uses while you work.

0.5.53

Fixed

  • Regenerate is now a real kill switch for a lost phone. Regenerating the pairing secret used to rotate the connection key only — a phone that had paired before kept receiving background alerts and Live Activities (project, agent and activity text) for up to two weeks. It now forgets every registered phone and unregisters each with the relay before the new secret exists; a phone that is still yours simply pairs again.
  • "Allow iPhone to connect" off now also stops pushes. It used to close the connection and hide the push toggle while background pushes carried on.

0.5.52

Added

  • Collect Diagnostics… in the menu, beside Report an Issue. It writes one zip to your Desktop — Perch's state (version, licence status, hook trust, which integrations are installed, your settings, phone registrations as fingerprints, how many sessions exist per provider) plus its logs — and shows it in Finder. Nothing is uploaded; you can open it before attaching it to an issue. Project folder names are replaced with tokens, and session records, usage data, agent configuration, keys and tokens are never included. The sheet also has the scan-diagnostics switch, which until now was a defaults write nobody could find.

Fixed

  • Codex transcripts now show MCP tool calls. Calls made through an MCP server — the GitHub app, documentation search, and the like — were missing from the conversation view for most of them: the model would reason, then answer, with no sign it had called anything. They now appear as a tool call with its result, and the ones Codex already recorded another way are not shown twice.

0.5.51

Added

  • Reply to and stop Antigravity CLI sessions from your phone. An agy session running in tmux or herdr now gets the composer and the Stop button on the iPhone and watch, like every other provider. Stop is hidden while the session is waiting on a permission prompt, because there the same key would answer "No" for you. Both were measured before being switched on.

Fixed

  • Devin's background subagents now show up. Newer Devin runs explore subagents in the background, and Perch showed nothing for them — the session looked stuck "running" with no activity while six of them worked. Each now gets its row for as long as Devin waits on it, and the mid-turn "finished" that Devin sends while waiting is ignored as it is for foreground subagents.
  • A phone you reinstalled the companion on no longer costs the Mac a write every few seconds. The old install's push registration was being reserved and released on every fleet change, forever. Perch now skips a registration it already knows will be refused, and forgets one that has been refused for a week.
  • Old session records are cleaned up. Sessions that ended without saying so — a killed agent, or Devin, which never sends a session-end — left their record on disk forever (over a hundred on one Mac). Records untouched for a week are now removed whatever state they were left in; they were already hidden from the fleet.

0.5.50

Added

  • Antigravity CLI sessions now count in Stats. The heatmap, streaks, session counts and active time include agy conversations, read from the CLI's own transcripts, with an Antigravity segment in the provider picker on the Mac and iPhone; the watch's all-provider totals include it. Token totals and the model breakdown stay "unavailable" for it — the CLI keeps no token counts or model names on disk, so Perch says so rather than showing zero. The iPhone now says so too: a provider with no token history reads "—" instead of "0". Conversations the CLI opened but you never typed into are not counted.

0.5.49

Added

  • Perch now sees Antigravity CLI sessions — live. Google's agy shows up in the fleet like every other agent: running, waiting on a permission prompt or a question, finished, or idle, with the folder, model and context usage. Perch registers itself as the CLI's status line (stacked under the CLI's own, or chained ahead of one you already had) and adds one Stop hook, both pointing at the bundled agy-report; both are removed by Remove Integration and the uninstall script. Finishing a turn plays the completion sound and sends the "finished" notification; pressing Escape does not. Sessions started before Perch installed the integration are found by scanning the CLI's own records (newest conversation per folder).
  • Antigravity's weekly quota, as usage bars. The CLI reports how much of each weekly limit is left — one for Gemini models, one for Claude and GPT — on every status-line refresh. Perch shows the tighter one as the headline bar with the other beneath it, with the plan tier, the reset time, and the usual running-low warning — on the Mac now, and on phone, watch and widget once the companion app is updated. No account login is stored: only a fingerprint, so a switched login is noticed.
  • Not yet for Antigravity: Stats, and typing into the session from the phone. Phone and watch need the matching companion update to show the new rows.

0.5.48

Performance

  • Perch finishes tidying itself after the CPU work in 0.5.47. Overlapping fleet scans now collapse into one; leftover lock files from old sessions are cleaned up on launch (150 of them on the machine this was found on); and two settings that were being re-saved unchanged every few seconds no longer are. Nothing you see changes.

0.5.47

Performance

  • Perch uses about a quarter of the CPU it did while agents work. A working fleet idled Perch at 12–16% of a core; the same workload now sits around 3%. Four things changed: a burst of agent activity now redraws the fleet once instead of once per event; reading whether a Claude turn was interrupted no longer re-reads a quarter-megabyte of transcript on every redraw; the menu bar label only re-renders when something it actually shows changes; and a long Codex turn no longer rescans megabytes of its own history every four seconds. Nothing you see changes — the Mac just does less to show it.

Changed

  • Perch does much less work while Claude's status line refreshes. Claude Code redraws its status line every few seconds per session, and Perch's helper rewrites four small files each time. Those files lived next to the session records, so every refresh made Perch re-read the whole records directory and redraw the menu bar. They now live in their own folder (…/Perch/aggregate/, moved automatically on first launch) with their own watcher, and unchanged numbers no longer trigger a redraw. Nothing you see changes.

Fixed

  • Perch tells you when its icon is hidden. On a MacBook with a notch and a full menu bar, macOS puts a new icon straight behind the notch, so a fresh install could be running with nothing on screen and no hint that it was. Perch now notices and sends one notification saying so, with the shortcut that opens the fleet window (⌃⌥⌘P). Clicking the notification opens it too. At most one notice a week, so if you tucked the icon away on purpose it will not keep telling you.
  • The fleet says when it is not current. When your Mac sleeps, every agent pauses with it, but the panel kept showing the last thing it saw as if it were live. Perch now shows one line as the Mac goes to sleep, one while it re-checks after waking ("Back from 25 min asleep — refreshing"), and one if checks stop landing for any other reason ("Last checked 3 min ago — this may be out of date"). Nothing is shown while everything is normal. On waking, Perch re-scans immediately and sends the result to your phone, rather than waiting for the next timer.
  • Your phone and watch know when the Mac is asleep. They used to show "Reconnecting…" with a spinner for the whole nap. Now the Mac tells them as it goes to sleep, and they say "Mac went to sleep 22 min ago — the fleet is paused" instead, and "Mac just woke — refreshing" when it comes back. While reconnecting for any other reason, they say how old what you are looking at is. The lock-screen card also dims within two minutes of the Mac sleeping rather than looking current for up to an hour. Needs the iPhone app 1.0.2.

0.5.46

Fixed

  • Your phone can find your Mac again after the network hiccups. If macOS's discovery service restarted — which it does on its own, and on some VPN and network changes — Perch stopped advertising itself on Wi-Fi and never started again. Nothing looked wrong: the Mac stayed connected over Tailscale and the menu bar was normal, but a phone on the same Wi-Fi searched forever. The longest this went unnoticed was eighteen hours. Perch now spots it and re-advertises on its own, which took under four seconds in testing.

Changed

  • Settings now tells you which network problem you have. "Wi-Fi discovery dropped — re-advertising" means Perch lost its spot and is getting it back by itself, with nothing for you to do. The Local Network permission prompt now appears only when permission really is the problem — the one case where you do need to open System Settings.

0.5.45

Changed

  • Messages you send from your phone stay private on the Mac. Until now the text was typed into the terminal in a way that briefly showed it to any other user account on the same Mac while it was being sent. It is now handed to the terminal directly, and never appears there.

Added

  • Multi-line messages from your phone. Pasting or dictating text with line breaks used to be refused. It now arrives in the agent as one message with its line breaks intact, for Claude Code, Codex, Cursor, Devin and Amp — each one was checked by hand first. (The Return key on the phone keyboard still sends; line breaks arrive by paste or dictation.)

Fixed

  • Sending from the phone is a little quicker. Long messages, and every message to Codex, used to pause briefly before submitting to make sure the agent had caught up. The new way of handing over text made that unnecessary, which was confirmed with 40 test sends before the pause was removed.

0.5.44

Added

  • Stop a Codex or OpenCode turn from your iPhone. Stop was Claude Code only; it now covers three of the six agents Perch supports. Each one was measured first — Devin's and Amp's interrupt keys turned out to do something else, so they stay out until there is a key worth sending.
  • Codex has one limit worth knowing. Stopping works while Codex is thinking or running a tool, which is most of a turn. It does nothing during the few seconds Codex is writing out its final answer, and Perch cannot tell those apart — so a Stop tapped right at the end may not land.

Changed

  • Stop no longer appears when a session is waiting on a permission prompt. Pressing Escape there does not stop the agent — it answers the prompt No. The button was quietly denying whatever was being asked, so it is gone for that case. Use Approve or Deny, which say what they do. Typing is unaffected.

Fixed

  • A denied permission no longer leaves a session stuck on "needs you". Answering a prompt at the Mac used to leave the phone showing a request that had already been dealt with, sometimes for ten minutes.
  • Security and reliability improvements.

0.5.43

Added

  • Reply to an OpenCode session from your iPhone. OpenCode joins Claude Code, Codex, Devin, Cursor and Amp — every agent Perch supports can now be typed into remotely. Stop is still Claude Code only.

Fixed

  • Security and reliability improvements.

0.5.42

Added

  • Reply to Cursor and Amp sessions from your iPhone. They join Claude Code, Codex and Devin as agents you can type into remotely, in tmux or herdr. Stop is still Claude Code only.

Fixed

  • Security and reliability improvements.

0.5.41

Added

  • Reply to a Devin session from your iPhone. Devin joins Claude Code and Codex as an agent you can type into remotely, in tmux or herdr. Stop isn't offered for Devin — its interrupt needs two presses of Escape, and a stray one at an idle prompt opens a menu that can undo work.

Fixed

  • Security and reliability improvements.

0.5.40

Changed

  • Your phone stays quiet when you're already watching. A finished turn no longer buzzes your phone while that agent's terminal is in front of you on the Mac.

Fixed

  • Security and reliability improvements.

0.5.39

Fixed

  • Long messages from your phone now actually arrive. A message over a couple of thousand characters could be reported as sent while the agent never saw it.

0.5.38

Added

  • Reply to a Codex session from your iPhone. Codex joins Claude Code as an agent you can type into remotely. Stop isn't offered for Codex yet.

Fixed

  • Notifications stop arriving after the moment has passed. An approval request that reaches your phone too late to answer is now dropped instead of buzzing about a decision that already went back to the terminal.

0.5.37

Fixed

  • The Live Activity card stops flickering between projects. When several agents were working it renamed its headline and reshuffled its dots every few seconds, too fast to read. It now stays on one session while that session is working, and only updates when something actually changed.

0.5.36

Fixed

  • The Live Activity on your iPhone stays put. It used to freeze and then disappear on its own when your agents went quiet, and a fresh card could show a moment that had already passed. Both are fixed, and updating Perch no longer leaves an old card stranded on your lock screen.

0.5.35

Added

  • Answer Claude's questions from your iPhone. When Claude Code asks a multiple-choice question, you can now tap the answer on a connected iPhone instead of walking back to the Mac. Off by default — turn it on in Settings → Notifications. While Perch waits for your answer the question does not appear in the terminal, so it only ever engages with an iPhone actually connected, and hands the question straight back the moment it disconnects.

0.5.34

Added

  • Sessions show their own name. A Claude Desktop conversation now appears under the title you gave it — or the one Claude wrote for it — instead of just the folder it runs in. Two sessions in the same project are finally told apart. Cursor, OpenCode, Amp and Devin sessions gained the same thing: they were already carrying a title that Perch never showed.
  • Cursor credit balance. If your Cursor account has credit on it, the amount left now sits beside your usage bars, the same way it does for the other providers.

0.5.33

Fixed

  • Perch does less work while your agents run. The menu bar was being redrawn five times more often than its text actually changed, and every update reread every session file on disk — including hundreds from sessions that ended weeks ago. Both are gone. Nothing looks different; there is simply less happening behind it.

0.5.32

Fixed

  • Two copies of Perch no longer fight over your agents. Starting a second one used to take the connection to your sessions away from the first, which kept running but stopped hearing anything — no error, no warning. A second copy now says so and quits.
  • The menu bar list scrolls. It had a limit of eight sessions before scrolling, which most people never reached, so the panel just kept growing. It's five now, and the scrollbar is visible so you can tell there's more.
  • The lock screen says what just finished. When your last agent stopped, the card spent its final seconds showing "no active sessions" instead of the work it had been following.

0.5.31

Fixed

  • Perch says when your Cursor sign-in has expired. It used to just drop the Cursor usage row, which looked exactly like having no Cursor account — so the bars quietly stopped updating with nothing to explain why, and no way back except guessing. The row now tells you to sign in again. A slow or throttled Cursor still says nothing, because that fixes itself.
  • A question from Claude no longer shows Allow/Deny. When Claude asks you something, neither button could answer it — Allow only approved the asking, and Deny stopped Claude asking at all. It now shows as a question.

0.5.30

Fixed

  • Perch no longer switches off your other Codex hooks. Codex remembers which hooks you approved by their position in the list. Perch used to reinstall itself at the bottom, which renumbered everything below it — so a hook you'd approved from another tool quietly stopped running, with nothing to tell you. Perch now keeps its place.
  • No more warning in every Codex session. Perch asked Codex for a five-second window when it finishes a session; Codex allows three, and said so in your terminal every time. It now asks for three.

0.5.29

Fixed

  • Perch is about three times lighter on your Mac. With agents working it used to sit at roughly 11% of a CPU core; it now sits at 3–4%. The menu bar icon, the four-second sweep of your sessions, and a question Perch asked macOS twelve times a second were each doing far more work than they needed to.
  • Usage warnings stop repeating. A "10% left" or "0% left" alert used to arrive again every 15–20 minutes for the same window, and starting Perch on an already-spent window announced it as news. You now get one warning per window, and a fresh one only when that window resets.
  • The completion sound no longer stutters the interface. Playing it briefly froze everything Perch was drawing.

Added

  • A switch to stop the icon animating, in Settings → Menu Bar. The icon stays still while agents work.
  • Warnings for per-model limits too. Quotas that sit beside the headline meters — Devin's daily allowance, Amp's per-model numbers — could run to zero without a word.

0.5.28

Fixed

  • Sessions stop claiming to work after they've gone. An agent that was killed, crashed, or whose terminal was closed could sit in the fleet as "working" indefinitely — keeping the menu bar icon animating and the lock screen asking about a session nobody could answer. A session that has said nothing for ten minutes now shows as idle. Nothing is deleted; it reappears as soon as it says anything.
  • Fewer late notifications. A push could hang on a dead connection for a full minute before giving up. Perch now gives up after ten seconds and tries once more, so an alert either arrives promptly or not at all.

0.5.27

Added

  • Reply to herdr sessions from your phone. Sessions running in herdr can now be answered and interrupted from the iPhone app, the same as tmux ones.
  • Perch tells you when it can't reach your phone. If notifications stop being delivered, Settings → Companion says so and shows the reason, instead of going quiet and looking like nothing was happening.
  • A fleet window, and a keyboard shortcut that always works. macOS hides menu bar icons when the bar gets full — and because Perch has no Dock icon, that could leave it running with nothing on screen to open it. Press ⌃⌥⌘P to open your fleet in a real window you can resize, move and leave open beside your work. It's the same fleet you get from the menu bar, and it's also in ⚙︎ → Open Fleet Window. Turn the shortcut off in Settings → General if you'd rather have the key back.

Fixed

  • Usage bars could freeze at the wrong number. A provider's usage percentage could stop updating and stay stale indefinitely — showing plenty of headroom on an account that had already hit its limit. Affected every provider's bars.
  • Two agents in one folder can both be replied to. Running two Claude sessions in the same project used to leave both of them without a reply box on the phone.
  • A finished session stays finished. A session that had ended could come back as idle and sit in the fleet indefinitely.
  • Quiet days are visible in the Stats heatmap. A day with a little activity was drawn so faintly it was almost identical to a day with none — measurably so, at a contrast ratio of 1.02 in the worst case, where 1.0 means "no difference at all". Active days now start darker, so you can see that you worked on a day, not only that you worked a lot. The Mac and iPhone grids had also drifted slightly apart; they now shade identically.
  • The Stats filter says "All", not "Both". It dated from when Perch tracked exactly two agents. There are six.

Changed

  • Settings is now four tabs — General, Menu Bar, Notifications and Companion — instead of one long scrolling list. Pairing your iPhone, adding a licence key and picking a menu bar icon each have their own place, and Perch reopens on the tab you used last.
  • Notifications stop piling up. A session that finishes, then asks for approval, then finishes again used to leave a separate banner for each. Now the newest news about a session replaces the old, and everything about one project stacks together in Notification Center. Approval requests are still kept separate from each other, so a prompt can never be quietly buried by another one.
  • Perch keeps still when you ask it to. With Reduce Motion turned on in System Settings → Accessibility → Display, the menu bar icon stops animating, the thinking word stops rotating and the "needs you" dot stops pulsing. All three still show exactly what they showed before — they just hold still.
  • Better with VoiceOver and larger text. The menu bar now says what it means out loud ("Perch, 3 working, 1 waiting for you"), each session reads as one sentence instead of a dozen loose fragments, and the small text throughout the panel scales instead of staying fixed.

0.5.26

Added

  • Amp support. Perch now shows your Amp CLI sessions in the fleet — which project each thread is in, whether it's running or idle, the tool it's using right now, its title, and an elapsed-turn timer — with a "finished" notification when a turn completes, and click-to-focus for the terminal it's running in. Zero setup: Perch reads Amp's own logs and writes nothing. Works on the Mac, iPhone and Apple Watch.
  • Amp usage bars. While an Amp session is open, Perch shows your Amp plan's usage meters and renewal countdown in the dropdown — and on your iPhone, Apple Watch and widgets — with a warning when a meter runs low. Uses the login the Amp CLI already has; nothing to set up. Turn it off with defaults write com.inkryptislabs.perch perch.ampUsage -bool false. Free-tier accounts get their meter and credits balance too, and the plan name now shows correctly next to the AMP label.
  • Amp in Stats. The Stats dashboard — heatmap, streaks, sessions, active days, longest session — now counts your Amp threads, with its own filter segment on the Mac, iPhone and Apple Watch. Token totals honestly exclude Amp (it records none), the same way Cursor's are handled.
  • Amp sessions update instantly — and can now ask for you. Perch installs a small plugin into Amp (removable, and it never touches your other Amp settings) that reports state the moment it changes instead of every few seconds — including when Amp is waiting for your approval, which now shows as "Waiting for you" with a needs-you notification on your Mac and phone, just like Claude Code. What your agents say and do stays private: the plugin sends session status only, never conversation content.
  • Perch Pro. Subscribe in the Perch app on your iPhone and paste the subscription ID into Perch on your Mac — either on the unlock screen or in Settings — and it unlocks Perch and lets you read your agents' conversations from your phone. A subscription unlocks the whole Mac app, so you don't need a licence key as well. Unlinking only forgets the ID on this Mac; it never cancels a subscription, which is managed in the App Store.

Changed

  • Reading conversations on your phone is now part of Perch Pro. Everything the $29 licence has always done is unchanged and still yours forever — the menu bar, the fleet, notifications, approvals and push. Reading transcripts on your phone has never been available outside TestFlight, so nobody loses anything they had.
  • Background push to your iPhone still needs a Perch licence. A subscription on its own doesn't carry one yet, and Settings says so where the switch is.

0.5.25

Fixed

  • The rest of 0.5.24's fix, for sessions Perch had already saved. That release stopped two same-id sessions from different tools being confused while running, but their saved files still shared one name, so one could go missing after a restart. Each session now gets its own file, and Perch renames what's already on your Mac when it starts. Nothing is lost.

0.5.24

Fixed

  • Two sessions from different tools could be treated as one. When their ids happened to match, one could disappear from the fleet or show the other's project, model or folder — and clicking its approval could open the wrong one. Perch now tells sessions apart by tool as well as id.

0.5.23

Fixed

  • Clicking a Codex session that's running in the Codex desktop app now opens that conversation. It was always meant to — but it only worked once Perch had found and read the session's transcript on disk, which takes a moment after a session starts. Click before that and you got the project folder in Finder instead, with no hint why. Perch now works out where a Codex session is running the moment it first reports in, so the conversation opens from the first click. Sessions in a terminal are unaffected: they still jump to the terminal, as before.

0.5.22

Fixed

  • The lock-screen Live Activity now goes away when your agents finish. It used to sit there for up to an hour afterwards, still showing the last thing it saw — so a glance at your phone could tell you an agent was working when it had finished minutes ago. It now shows the finished fleet briefly and then dismisses itself. Starting another agent brings it straight back.
  • iPhone: the lock-screen Live Activity could freeze on a stale state. When several agents changed state in quick succession, iOS would quietly stop delivering updates for a while — leaving the lock screen showing something that had finished minutes earlier. Perch now tells iOS it needs frequent updates. (iPhone app only; you can turn frequent updates off for Perch in iOS Settings if you'd rather save battery.) Already on TestFlight as build 39.

0.5.21

Added

  • OpenCode is now fully integrated with Perch. Local OpenCode sessions appear live on the Mac, iPhone, Apple Watch, widgets and Live Activities, with model, exact cost, five-part token usage, todos, subagents, notifications and Stats. Perch installs a small owned OpenCode plugin and keeps all state handling, validation and persistence in its signed Swift helper.
  • OpenCode permissions and simple questions can be answered from the Mac. Allow maps to OpenCode's one-time approval and Deny rejects it. Exactly one free-text question can be answered directly from the notification without Accessibility access; structured questions stay in OpenCode.
  • OpenCode Go usage estimates. When local sessions use opencode-go, Perch shows clearly labelled rolling five-hour, ISO-week and anchored-month estimates. The calculation is entirely local: no cookies, credentials or usage API calls.

Security

  • OpenCode message bodies, text deltas, reasoning and attachments never cross the plugin boundary. Plugin files are owner-only and hash-verified, SQLite is opened read-only, PID reuse is checked with process start time, and older companions receive compatibility-stripped records.

Note

  • Restart any OpenCode session that's already open. OpenCode loads plugins when it starts, so a session running while Perch updates won't report until you start a new one — it'll sit at "Idle" until then. New sessions work straight away, with nothing to set up. The same applies to Devin sessions open when you updated to 0.5.20.
  • Update the iPhone and watch apps alongside this version. An older companion doesn't know about OpenCode yet and will label OpenCode sessions as another agent; everything else keeps working and the label corrects itself once the phone app updates.

0.5.20

Fixed

  • Devin sessions were still stuck on "Idle" in 0.5.19. Everything 0.5.19 described was built, but the part that switches it on never ran, so Perch never actually started listening to Devin. Update and it works — no setup, no setting to find. Stats and the usage bars were unaffected and worked in 0.5.19.

0.5.19

Added

  • Devin sessions now show what they're doing. Until now a Devin session appeared in the list but always sat at "Idle", because nothing Perch could read said whether it was mid-task. It now goes to work and back to idle as it happens, tells you what it's running, shows its to-do list, and sends the "finished" alert when it's done — the same as Claude Code, Codex and Cursor. Nothing to switch on.
  • Clicking a Devin session opens its terminal. It used to open the folder in Finder instead.
  • Devin appears in Stats. The heatmap, streaks, active days, token totals and favourite model all include it now, and the first scan after updating fills in your past Devin sessions — so all-time totals will jump and older days in the heatmap will darken. One quirk worth knowing: a Devin session joins Stats when it ends, not while it's running, because that's when Devin writes its record.
  • Devin usage bars. Your weekly and daily quota, and your plan name, next to the Claude, Codex and Cursor bars — on the Mac, iPhone and watch. Perch uses the login Devin already stored on this Mac and never changes it.

Note

  • Perch can't ask Devin for permission the way it does for Claude Code and Codex, so Approve/Deny from your phone or watch still doesn't apply to Devin — Devin has no way to hand a prompt to another app. The low-usage warning tracks your weekly quota; the daily one is shown but doesn't trigger an alert.

0.5.18

Added

  • Devin sessions now show up in Perch. If you use the devin command-line agent, its sessions appear in the list alongside Claude Code, Codex and Cursor — with the project, the model, the session title and Devin's own logo. There's nothing to set up and nothing to turn on: Perch reads what Devin already keeps on your Mac, and changes none of it.

Devin sessions are shown as idle rather than working. Devin doesn't record anywhere Perch can read whether it's mid-task or waiting for your next prompt, so rather than guess and get it wrong, Perch shows the session without claiming it's busy. That also means no "finished" alert for Devin yet. Clicking a Devin session opens its folder rather than its terminal window, which is the next thing to fix.

Devin can't ask Perch for permission the way Claude Code and Codex do — it has no way to hand a prompt to another app — so Approve/Deny from your phone or watch doesn't apply to Devin sessions.

Fixed

  • Notifications on your phone now name the right agent. A finished or needs-you alert from a Cursor session said "Claude Code" underneath it. Alerts on the Mac itself were always correct; this only affected the ones pushed to your phone and watch.

Note

  • Update the iPhone and watch apps before, or together with, this version. An older iPhone app doesn't know about Devin yet and will label Devin sessions "Claude Code" — everything else keeps working, and the label corrects itself once the phone app updates.

0.5.17

Added

  • Clicking a session now opens the exact tab it's running in, in iTerm2 and Terminal. Until now Perch could only bring those apps to the front and leave you to find the right tab yourself; Warp was the only terminal it could open precisely. Tapping a notification lands in the same place, and replying to a question straight from a notification works in those terminals too.

Note

  • The first time you jump to a session in Terminal, macOS asks whether Perch may control it. That's what lets Perch open the right tab. If you decline, clicking simply brings Terminal to the front as before.

0.5.16

Fixed

  • The Cursor usage bar no longer disappears when you stop using Cursor. It was the only usage bar that vanished after a quiet spell, and it was never there at all when Perch had just started — Claude's and Codex's stay put because their numbers are saved on this Mac, and now Cursor's are too. It still only refreshes while you're working, and the time on the right still turns orange to tell you when a reading is getting old. The bar clears when your billing period ends, since by then the percentage is about a month that's over.

0.5.15

Changed

  • The usage section shows each agent's logo. Claude's spark, OpenAI's knot and Cursor's cube replace the plain coloured dots, matching how session rows already identify a provider — on the Mac, iPhone and watch.
  • iPhone: the usage bars now match the Mac. They use the full width of the row, line up with the provider line above them, and the reset time sits next to its percentage instead of drifting off to the right.

Fixed

  • iPhone: a usage row with no reset time no longer has a longer bar than the others. Same defect the Mac had — a window that reports no reset, such as Claude's per-model bar, stretched further right and pushed its percentage out of line.

Note

  • The iPhone and watch app also pick up everything the Mac gained since the last companion build: Cursor sessions, Cursor usage, and the git branch on each row.

0.5.14

Fixed

  • A Claude session in a terminal is no longer badged APP. If Perch hadn't yet matched the session to a running process, it assumed the session belonged to the Claude desktop app — even when the session itself recorded which terminal had started it. Two sessions of one project could sit side by side badged differently for no reason you could act on.

Added

  • Session rows now show which git branch they're on. Two sessions in the same project used to look identical — a main checkout and a worktree both just read perch. The branch appears next to the project name, on the Mac and on your iPhone. Sessions outside a git repository are unchanged. A detached checkout shows the short commit instead.

0.5.13

Changed

  • The usage bars line up with the row above them and use more of the width. The provider line (CLAUDE Max 5x … $215 5:09 PM) and the bars beneath it now start and end on the same edges, and the bars themselves are longer again — the label, percentage and reset-time columns were all wider than the text they hold. The reset time sits closer to its percentage instead of drifting off to the right.

0.5.12

Fixed

  • A usage row with no reset time no longer has a longer bar than the others. 0.5.11 widened the bars but left one case out of column: a window that reports no reset — Claude's per-model bar, for instance — stretched further right and pushed its percentage out of line with the rows above it.

0.5.11

Changed

  • The usage bars now use the full width of the panel. They were a fixed width with empty space to their right; each bar is about 30% longer now, so small differences between them are easier to see. Everything still lines up column to column, and a reset time that would have been clipped shrinks to fit instead.

0.5.10

Added

  • Cursor usage now reaches your iPhone and Apple Watch. The Included and API bars that the Mac has been showing since 0.5.4 now appear in the usage section on the phone, and on the watch alongside Claude and Codex. Needs the matching companion update; an older phone simply won't show the row.

Fixed

  • A model bar sitting at 0% is now shown on the phone too. The Mac started showing those in 0.5.5; the phone and watch were still hiding them, so they listed fewer bars than the Mac beside them.

0.5.9

Fixed

  • Cursor's parallel subagents no longer leave phantom sessions behind. When Cursor splits work across several agents at once, each one runs as a session in its own right and simply stops when it's done — it never reports finishing. So a single delegation left four or five rows spinning in your list long after the work was over. Those now settle within about a minute and a half.
  • No more late "finished" notifications for work that already ended. When Perch gives up waiting on a Cursor session that went quiet, that's Perch losing track — not the agent finishing — and it no longer announces it as a completion. One parallel delegation would previously have sent you four.

0.5.8

Fixed

  • Installing Codex while Perch is running is now noticed. 0.5.7 said pressing Re-check would pick it up, but Re-check sits inside the very warning that gets hidden when Perch thinks Codex isn't there — so it wasn't available exactly when you'd want it. Simply opening Settings now looks again.
  • Perch no longer stays quiet just because it couldn't find Codex once. If the check fails for some passing reason rather than because Codex is genuinely missing, the hook-trust warning is shown rather than swallowed. Only a real absence hides it.
  • A lookup already under way can no longer overwrite a newer, correct one and put Perch back to believing Codex is missing.
  • Settings now re-checks Codex every time you open it, not just the first time. The window is kept around and reused between openings, so the checks that were meant to run on each visit were quietly only running once per launch — including the "are these hooks still trusted?" check.

0.5.7

Fixed

  • No more "trust these hooks" warning for a Codex you don't have. Perch decided Codex was installed by looking for its ~/.codex folder — but removing Codex doesn't necessarily remove that folder, so anyone who had tried Codex and moved on could be told forever to re-approve hooks for an agent that wasn't there. It now also checks that a codex you can actually run exists. If you do have Codex, nothing changes; the warning still appears whenever it genuinely needs your attention.
  • Re-check now looks for Codex again from scratch. If you install Codex while Perch is already running, pressing Re-check picks it up instead of you having to restart Perch.

0.5.6

Changed

  • The Codex and Cursor integration switches are gone. Both were on by default and both did nothing at all if you didn't have that agent installed, so for almost everyone they were two controls that never needed touching. Perch still sets up and tears down those integrations exactly as before — ./scripts/uninstall.sh remains the way to detach it completely.
  • The "Codex needs you to trust these hooks again" warning stays, along with its Re-check button, and now appears only when there's actually something to do. It's the one part of that section that asks something of you rather than offering a preference: Codex won't run a hook it hasn't approved, and it tells you nothing when it skips one.
  • The Usage section in Settings is gone. It had no switches left in it, only a paragraph. What it explained — that the usage bars are fetched from Claude, Codex and Cursor using the logins those agents already saved on this Mac, and that an agent you don't use is never contacted — now lives in SECURITY.md, under "What Perch sends off this Mac", along with everything else that leaves your machine.

0.5.5

Changed

  • Per-model usage bars are on for everyone, and the switch is gone. They used to be behind a "Show per-model limits" setting that was off unless you found it. It also did more than its name suggested: it's what keeps the 5-hour and weekly numbers coming from Claude and Codex themselves, rather than from whatever was last written on this Mac — which goes stale as soon as your sessions go quiet.
  • Model bars now show even at 0%. Previously a model you hadn't used yet was hidden, which meant most people saw no bars at all and had no way to tell the feature was working. A model with its own weekly cap now always gets a row.
  • Cursor gets a second usage bar too. Cursor meters your billing period twice — once against your plan's total allowance and once against its API allowance — and those two really do differ. The headline bar is unchanged; the API figure now appears beneath it, the same way Claude's per-model bars sit under its weekly one.
  • The Usage section of Settings has no switches left. It now just explains where the numbers come from: Perch asks each service directly, using the login that agent already saved on this Mac, read-only, and only while you have a session open with that agent.

0.5.4

Changed

  • The "Show Cursor usage" switch is gone. Cursor's usage bar now just appears, the same way the Claude and Codex ones always have — once it was on by default, a switch that only ever turned it off was one setting too many. Nothing else changes: it still only asks Cursor while a Cursor session is open, and does nothing at all if you don't use Cursor.

0.5.3

Two problems that only showed up once Cursor's own app — rather than just the cursor-agent command line — was actually being used.

Fixed

  • A phantom "unknown" Cursor session. Cursor's app sends Perch a signal for an empty, unsent chat box, and Perch was turning that into a session row labelled "unknown" that sat there idle forever. It's not a session you started and there was no way to get rid of it. Perch now ignores those, and any one already sitting in your list disappears.
  • Closing Cursor left its sessions on screen. A session running inside the Cursor app kept showing as busy — "Thinking…", spinner and all — for fifteen minutes after you closed the app, and then lingered as idle indefinitely. Those now end as soon as Cursor quits. Sessions you started with cursor-agent in a terminal are untouched: those quite legitimately outlive the app.

0.5.2

Changed

  • Cursor usage now shows by default. In 0.5.1 you had to find a switch in Settings and turn it on, which meant most people upgraded and saw no Cursor usage at all — while the Claude and Codex bars have always appeared without being asked for. It's still a switch, so you can turn it off; it just starts on now. Nothing happens on a Mac without Cursor: Perch only asks Cursor for your usage while a Cursor session is actually open, so if you don't use Cursor it never makes the call.

0.5.1

Follow-ups from using 0.5.0's Cursor support in anger. Cursor rows were missing three things the Claude and Codex rows have had all along.

Added

  • Cursor account usage. A new switch in Settings → Usage shows how much of your Cursor plan's included usage this billing period has spent, as a bar alongside the Claude and Codex ones, with your plan name and when the period resets. You'll also get the same "usage running low" warning the other two give you.

It's off by default, and unlike the other two it has to ask Cursor over the internet — Claude and Codex leave their usage figures on your Mac, Cursor doesn't. When you turn it on, Perch reads the login cursor-agent already saved and asks Cursor for the number; macOS may ask your permission the first time. Perch only ever reads that login and never changes it. Leave the switch off and nothing is sent anywhere.

Fixed

  • Cursor sessions now show whether they're running in a terminal or in the Cursor app, with the same CLI badge Claude Code and Codex rows have. Perch had been working this out correctly since 0.5.0 and simply wasn't drawing it.
  • Cursor sessions now show which model they're using. If you're on Auto — the default — the row says "Auto" instead of leaving the space blank, which looked like Perch had failed to detect anything. Pick a model yourself and it shows that name.
  • Cursor's logo is now Cursor's actual logo. The mark shipped in 0.5.0 was drawn from scratch, before the real artwork was to hand, and was the wrong shape — a plain cube, missing the notch that makes it Cursor's.

Note

  • Cursor usage is Mac-only for now. The iPhone and watch apps still show Claude and Codex usage only.

0.5.0

Added

  • Cursor is now a supported agent, alongside Claude Code and Codex. Your Cursor sessions show up in the menu bar, on your iPhone and on your watch, the same as the other two: which project, what it's doing right now, and whether it's working or finished. Both the cursor-agent CLI and the Cursor app are covered by the same one-time setup.
  • Cursor sessions appear even if you started them before Perch was running, and clicking one jumps to the terminal it's in.
  • "Finished" notifications for Cursor turns, on the Mac and pushed to your phone.
  • Per-session token and context figures for Cursor.
  • Cursor in Stats — sessions, active days, streaks and the contribution heatmap, with its own filter next to Claude and Codex.
  • A "Cursor real-time integration" switch in Settings, on by default and a no-op if you don't have Cursor. It adds one entry to ~/.cursor/hooks.json, leaves any hooks other tools put there untouched, and removes cleanly when switched off.

Fixed

  • Cursor sessions used to show up as Claude Code sessions that never did anything. If you had Perch and Cursor both installed, Cursor was already quietly triggering Perch and creating a session that was labelled Claude Code, showed "default" as its model, and sat in its starting state forever no matter how much work Cursor did. Those rows are gone — Cursor sessions are now reported as Cursor sessions, correctly.
  • scripts/uninstall.sh now removes Perch's Codex and Cursor hooks as well as its Claude Code ones. It previously left them behind, so uninstalling with --app deleted the programs those hooks pointed at and left the agents running a command that no longer existed.

Note

  • Cursor has no Allow/Deny in Perch, deliberately. Cursor's approval hook fires before every shell command, not only the ones it was going to ask you about — so wiring it up would turn routine, already-approved commands into lock-screen prompts on your phone. Cursor sessions therefore never show "Needs you"; approvals stay in Cursor itself. Claude Code and Codex are unchanged.
  • Perch shows no cost estimate for Cursor sessions yet, and Cursor contributes no token totals to Stats — those numbers aren't written anywhere Perch can read them after the fact. Its sessions, days and streaks all count normally, and Stats now says which agents a token total actually covers rather than quietly leaving one out.

0.4.18

Changed

  • The permission approval on iPhone now shows a countdown, so you can see how long you have to answer before it hands back to your Mac or the agent's own prompt — matching the Apple Watch. It also counts down to the real deadline now, so a phone that reconnects partway through the window shows the time that's actually left.
  • If your iPhone has notifications turned off (or can't show them), Perch no longer holds a permission for the full phone window waiting on an alert you'd never see — it hands back to your Mac or the agent's own prompt sooner.
  • Simplified Perch's Codex hook (removed a field that did nothing). Codex will ask you to approve the hook again — run /hooks in Codex and trust Perch's entry; the menu bar reminds you if anything isn't trusted.

0.4.17

Changed

  • Tapping a Codex permission notification now jumps to the right place — the Codex desktop app or the exact terminal pane — and hands the decision back to Codex's own prompt, instead of sometimes only revealing the project folder. If you don't answer in Perch, Codex falls back to its own approval prompt as before, showing the gated command.

Note

  • This release updates Perch's Codex hook, so Codex will ask you to approve it again. Run /hooks in Codex and trust Perch's entry — the menu bar will remind you if anything isn't trusted.

Correction

  • An earlier draft of these notes said Codex would show "Waiting for approval in Perch…" during the pause. It doesn't — that hook field turned out to be a hooks-summary label, not a live prompt message. Codex shows the gated command itself while it waits, which already makes the pause clear.

0.4.16

Changed

  • If Codex isn't running Perch's hooks, the menu-bar dropdown now says so. Previously this only appeared in Settings, so you had to go looking for a problem you had no reason to suspect — the integration would read as on while doing nothing. Click the banner for the details and the fix.
  • Perch re-checks with Codex directly after an update. Approving a hook in Codex ties the approval to that exact hook, so a Perch update can quietly invalidate it; this is the case Perch couldn't previously detect on its own.
  • First-run welcome now mentions Codex when you have it, and walks Codex users through the one step Perch can't do for them: running /hooks to approve the hooks it just installed.

Fixed

  • Claude Code sessions running inside the Claude desktop app were labelled CLI. The desktop app runs its own copy of Claude Code, and Perch couldn't tell it apart from one you started in a terminal. They now read APP, and clicking one brings the desktop app to the front instead of opening the project folder in Finder.

0.4.15

Fixed

  • Codex integration now works when Codex is installed through a version manager (nvm, fnm, Volta and similar). Perch could find Codex but not run it: the launcher needs node sitting beside it, and Perch wasn't looking there. This is what kept 0.4.13's session-end tracking and 0.4.12's hook check from doing anything on those setups.

Note

  • On Codex 0.145 or newer this adds one more Codex hook. Codex asks you to approve new hooks before it runs them — Perch will say so in Settings. Run /hooks in Codex and trust Perch's entry.

0.4.14

Fixed

  • Perch now finds Codex the way your terminal does. If you install Codex through a version manager (nvm, fnm, asdf) or only have the Codex desktop app, Perch could miss it entirely when launched normally — which quietly switched off the Codex improvements in 0.4.13 and the hook check added in 0.4.12. Both work now.

Note

  • If you're on Codex 0.145 or newer, this adds one more Codex hook. Codex asks you to approve a hook before it will run it — Perch will say so in Settings. Run /hooks in Codex and trust Perch's entries.

0.4.13

Fixed

  • Codex sessions now end cleanly instead of lingering until they age out, so "hide idle after…" and history pruning treat them the same as Claude's. Needs Codex 0.145 or newer; older versions are unaffected.
  • Codex: after you answer a question, the session no longer keeps showing as waiting on you.

Note

  • This update adds one more Codex hook, and Codex asks you to approve a hook before it will run it. Perch will tell you in Settings if there's anything to approve — run /hooks in Codex and trust Perch's entries.

0.4.12

Fixed

  • Codex integration: Perch now checks whether Codex is actually running the hooks it installed. Codex asks you to approve a hook before it will run it, so the integration could show as on while doing nothing — no live session state, no "needs you" alerts, and no Allow/Deny. Settings now says when that's the case and which entries to approve with /hooks in Codex, including after a Perch update changes them.

0.4.11

Fixed

  • Bug fixes and improvements: when an agent asks you a question, the notification now shows the question instead of Allow/Deny buttons that couldn't answer it; session state tracking is more reliable when several agents report at once; and a brief push-service hiccup no longer drops a "needs you" alert.

0.4.10

Changed

  • Housekeeping: the in-app purchase link now points at Perch's standard price. Existing licences are unaffected.

0.4.9

Fixed

  • The Live Activity now appears while agents are working — not only when one needs you. Previously the lock-screen fleet card could only start from a "needs you" moment, so after anything removed it (iOS removes Live Activities every time the app updates, including TestFlight updates) your lock screen stayed dark until the next approval prompt — even with agents visibly working. Now, whenever agents are active and your phone has no card, Perch brings it back on its own. Swiping the card away is still respected: it stays gone for an hour (a real "needs you" can still bring it back sooner). Works with your current phone build; pair with TestFlight build 27 for the fastest after-update recovery.

0.4.8

Changed

  • The agent's mark now leads each session row. Claude's spark or OpenAI's knot sits at the start of the row, with the status indicator tucked underneath it. The marks line up in a column now, so you can scan straight down the list to see whose session is whose — previously the mark sat after the project name, where it shifted around depending on how long the name was. Same on the Mac and the iPhone; the Apple Watch row is unchanged. Pair with TestFlight build 26 for the phone side.

0.4.7

Fixed

  • Sessions with background agents no longer show "Idle". When Claude hands work to background agents and its main thread pauses, the session now keeps showing as working — in the menu bar, the session list, the Live Activity, and on your phone — for as long as an agent is actually active. The "finished" notification now arrives when the work is truly done (agents included), not when the main thread pauses.
  • Dynamic Island text no longer gets clipped by the corners. The expanded island's curved corners could slice the first and last characters of the bottom row ("perch" became "erch"). Everything now sits safely inside the curve.

Changed

  • Which agent, at a glance. Session rows on the Mac, iPhone, and Apple Watch now show the agent's mark — Claude's spark or OpenAI's knot — instead of a text pill (or, for Claude, nothing). The CLI / DESKTOP pills stay: they say where a session runs; the mark says whose it is.
  • A calmer "needs you" card on the lock screen. The alert Live Activity now matches the calm card's look: what needs approving, one countdown line with a draining bar, and the fleet dots up top — instead of a wall of numbers, bars, and mini-rows. Pair with TestFlight build 25 for the phone-side changes.

0.4.6

Changed

  • A much richer Live Activity on your iPhone and Apple Watch. The lock-screen card now uses its full canvas: a clear headline ("2 agents working"), a row for each active session with its own live timer, and — when Claude is working through a task list — a progress bar showing exactly how far along it is ("Task 4/5 · Hardening provisioning fallback"). When an agent needs you, the card flips to a bigger, clearer alert: what to approve, a full-width countdown, and what the rest of your fleet is doing. The Dynamic Island and the watch Smart Stack card pick up the task progress too. Pair with TestFlight build 24 of the companion app — older phone builds keep working with the old card.

0.4.5

Fixed

  • Plan approvals: honest and instant. It turns out current Claude Code ignores any plan approval sent from outside the terminal once its plan screen is up — so 0.4.3's "approve plans from your phone" could never actually work, and tapping Allow just meant approving again at the terminal. Perch no longer pretends: when a plan is ready you get a simple heads-up — "Plan ready — review and approve in the terminal" — with no Allow/Deny buttons that can't do anything and no lock-screen countdown that lies. The plan and its approval prompt appear in your terminal immediately, as they always did. (Remote plan approval returns the moment Claude Code honors it.)
  • Approving ordinary tools from your phone keeps working on new Claude Code. Recent Claude Code versions quietly drop an approval unless it carries the tool's input back — Perch now includes it, so remote Allow keeps landing.
  • Fixed a crash in Perch's hook helper when an approval decision arrived just after you'd already answered the same prompt at the terminal.

0.4.4

Fixed

  • No more phantom "NEEDS YOU" during agent fan-outs. When a Claude session runs background agents (planning, parallel exploration), an agent's own permission prompt could leave the session stuck showing "NEEDS YOU / Approve: …" for many minutes after the prompt was already resolved — with nothing to approve at the terminal. Perch now checks whether the session is actually waiting on a prompt and clears the false alarm within seconds. Real prompts still show for exactly as long as they're on screen.

0.4.3

Fixed

  • Approving a plan from your iPhone now actually works. When Claude Code finishes planning and asks "ready to execute?", tapping Allow on your phone used to do nothing unless you answered within 45 seconds — nearly impossible when you're away from your desk (which is exactly when you get the push). Plan approvals now stay answerable from your phone for 4½ minutes, and the lock-screen countdown matches the real deadline instead of dimming "too late" early. Ordinary tool approvals are unchanged. If nobody answers remotely, the terminal prompt appears as before.

0.4.2

Fixed

  • Codex "finished" notifications now show what the session actually said. With Codex's "Approve for me" mode on, the notification could show a raw blob of internal approval data ({"outcome":"allow"…}) instead of the assistant's closing message. Perch now reads the message from the session itself — never from the approval machinery — and finds it reliably even for sessions that have been running for days.

0.4.1

Fixed

  • Codex sessions no longer show "Idle" mid-task. During a long Codex turn with a lot of output, the menu bar could flip to Idle while Codex was still visibly working. Perch now looks further back in the session log to find the turn's true state, so the working indicator stays accurate through even the longest tasks.

Changed

  • The first Stats scan is more than twice as fast. The one-time read of your history when you first open Stats now finishes in less than half the time it did in 0.4.0, with the same low memory use. (Already-scanned Macs won't notice — later opens were always instant.)
  • Lighter on your Mac. The background check that keeps the session list fresh no longer launches helper processes every few seconds and reads session activity far more efficiently — less CPU and battery for the same up-to-date menu bar.

0.4.0

Added

  • Stats. A new dashboard (menu-bar gearshape → Stats…, plus a one-line glance in the popover) showing your activity across both Claude and Codex: a GitHub-style contribution heatmap, current/longest streaks, active days, total tokens, favorite model, longest session, most-active day, and a per-model breakdown — all with All-time / 30-day / 7-day and Claude / Codex / Both filters. It's computed entirely on your Mac from the sessions you already have; nothing leaves your machine, no sign-in. The first open reads your history once (then it's instant), and your stats also appear on the iPhone and Apple Watch companions.

0.3.9

Changed

  • A clearer usage view. Each limit is now a labelled progress bar instead of a cramped line of numbers — 5-hour, weekly, and each per-model window, filling green → amber → red as you approach the cap. A limit you've hit is tinted red so it's obvious at a glance, spend and credits move to their own spot on the right, and the bars use the full width. Reset times still tap to switch between a countdown and the exact time.

0.3.8

Added

  • Reset times on every usage window. Each limit — 5-hour, weekly, and per-model — now shows when it resets. Click any reset to switch the whole app between a countdown ("·4h") and the exact clock time ("·2:40 PM" / "·Jul 24"); hover to see the other form.
  • Lines changed per session (Claude). Each Claude session row now shows how many lines it has added and removed (e.g. "+28,411 −5,354"), right from Claude Code's own count.

0.3.7

Added

  • Per-model usage limits (optional). A new Settings toggle, Show per-model limits, adds each model's weekly bar to the usage strip — Claude's per-model weekly windows and Codex Spark. It reads your existing Claude/Codex login read-only, with no sign-in, and never changes that login. Off by default; if it can't reach the data it quietly leaves your usual limits in place.

0.3.6

Added

  • More in your Codex usage line. Alongside the 5-hour and weekly limits, Perch now shows your extra-usage credit balance and today's spend — computed locally, no extra login. Claude shows today's exact spend too.

Fixed

  • Correct Codex weekly limit. When Codex reports only your weekly window, Perch was labelling it as the 5-hour one. It now identifies each window by its real duration, so the numbers line up with what Codex tells you.

0.3.5

Changed

  • Much better Codex support. Perch now tracks every Codex session you have open — whether it's running in the ChatGPT desktop app or as codex in a terminal — instead of missing some or showing the wrong details. Each row is tagged CLI or DESKTOP so you can tell them apart at a glance, and clicking one takes you to the right place: your terminal pane for a CLI session, or straight to the conversation in the Codex desktop app. Long-running and multi-session setups (several Codex windows, even in the same project) all show up correctly now.

0.3.4

Fixed

  • All your Codex sessions now show up, not just one. Perch used to miss Codex sessions running in the ChatGPT desktop app — often showing only one of several, or the wrong details for it. It now tracks each Codex session directly, so every one you have open appears with the right project and status, and the helper agents a session spawns no longer show up as extra rows.

0.3.3

Changed

  • A completely redesigned Live Activity. The lock-screen card now changes with your fleet: calm and green while agents work (one dot per session, a live elapsed timer), flipping to an amber "needs you" the moment one is blocked — with a live countdown showing how long you have to answer from your phone before the agent falls back to the terminal. Timers tick on their own, and file paths no longer appear on your lock screen. Pair with the latest companion app from TestFlight.

0.3.2

Fixed

  • The fleet Live Activity now starts on your iPhone by itself. When an agent needs you — phone in your pocket, app closed — the live fleet card appears on the Lock Screen and in the Dynamic Island on its own. (The start request didn't meet Apple's requirements, so iPhones quietly ignored it.) Pair with the latest companion app from TestFlight for the full experience.
  • Live Activity updates no longer count against Apple's push budget, so a busy fleet can't get your lock-screen updates throttled.

0.3.1

Fixed

  • Approve from your iPhone now works end to end. When an agent asks for permission, the request reaches your phone — even if the companion app was closed: open it and the approve sheet is waiting. Tapping Allow or Deny unblocks the agent right away. (Previously the prompt could be missed and you'd have to fall back to the terminal.) Needs the latest companion app from TestFlight.

0.3.0

Changed

  • A more reliable connection to your iPhone. Perch now keeps the companion link healthy — reclaiming stalled connections and holding steady ones open — so the fleet on your phone stays live and in sync.
  • Version-aware pairing. The Mac and the iPhone app now check they're on compatible versions and tell you to update if they've drifted apart, instead of quietly showing stale data.

Security

  • Your session data is more private. Perch now keeps its own runtime data in a private, app-owned location (out of the shared ~/.claude folder), tightens file permissions, and validates every session identifier before it touches disk — so session details stay yours on a shared Mac.

0.2.1

Added

  • Release notes in the update dialog. When a new version is available, the updater now shows what changed — starting with this one.

Changed

  • Internal reliability improvements to how Perch talks to your agent sessions.

0.2.0

Added

  • Report an Issue directly from the menu, with a safe way to attach a screenshot that won't leak your project names or commands.
  • Reach your Mac from the iOS companion while you're away from home.

Changed

  • Hardened how Perch stores its local state and talks to Claude Code and Codex, and tightened the security of push notifications end to end.

Fixed

  • Perch no longer risks overwriting a custom Claude Code or Codex settings file it can't safely read.
  • More reliable real-time updates and push alerts under load.