Guides
A clear next step.
Connect your first session, understand a request or work through a missing state. Start with the task you want to complete.
Get started with Perch on your Mac
Check Perch requirements, review local agent hooks, connect your first session and understand the three status states before enabling answers.
Open the guidePerch compatibility: Claude Code, Codex and Cursor
Compare Perch support for Claude Code, Codex CLI and Cursor local Agent: status, approvals, questions, plans, replies and navigation limits.
Open the guideApprove, answer and reply from Perch
Learn Perch’s opt-in answering workflow, supported provider actions, two-second undo and handoff back to the agent’s own app.
Open the guidePerch keyboard shortcuts and the review loop
Open Perch with Control-Option-C, navigate sessions and use Return, number keys and Esc for supported answers and the two-second undo.
Open the guideWhat Perch stores and which permissions it needs
Understand Perch’s local status storage, in-memory requests and optional Automation permission. No screen recording, microphone or Accessibility.
Open the guideWhat to check when agent status is not updating
Check Perch’s connection, new sessions, hidden sessions and provider limits when activity or an expected request does not appear.
Open the guideKeep the next prompt beside your coding agents
Use Perch’s ten local sticky notes for follow-up prompts, acceptance criteria and review reminders, then copy them into your coding workflow.
Open the guide
Read as Markdown · Product summary · Full text · Content index