Guides

Perch keyboard shortcuts and the review loop

Updated · 2 min read

Perch can keep the routine part of checking an agent on the keyboard. The important part still happens before the keypress: read which session is asking and what your answer will authorize.

The core shortcuts

Default Perch keyboard controls
KeyUse
Control + Option + COpen Perch from another app; the shortcut is configurable
Arrow keysMove between sessions
ReturnAllow the displayed supported tool request
Number keysChoose a numbered Claude Code answer
EscUndo during the two-second Sending window

Use one deliberate review cycle

  1. Open Perch with the shortcut.
  2. Move to the session you want to review.
  3. Read the project, request and available actions.
  4. Use the key for the visible action. If it was a mistake, undo during Sending.
  5. Review the next session separately rather than treating requests as a batch of identical approvals.

The action depends on the integration

Numbered question forms and plan review are Claude Code features. Codex supports allow, deny and replies. Cursor supports replies after a completed turn. A shortcut does not add an action that the integration lacks.

The undo key only applies during the two-second Sending period. Once a request has reached the agent, undo does not reverse a command, a file edit or a completed turn.

When a shortcut seems unavailable

Check the configured shortcut in Perch and whether another app uses the same combination. You can still open Perch from the screen-edge tab or menu bar.

If the shelf opens but a request is missing, check whether the agent is already asking in its own app. Perch steps aside when that app is in front, and missing provider events are a separate compatibility issue.

Your agents, one glance away.

Perch is launching soon. Join the launch list to hear when it is ready.

macOS 14+ · Apple silicon · Native SwiftUI + AppKit

Read as Markdown · Content index · Contact support