# Guides

Canonical: https://perched.fyi/guides/

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](https://perched.fyi/guides/getting-started/): Check Perch requirements, review local agent hooks, connect your first session and understand the three status states before enabling answers.
- [Perch compatibility: Claude Code, Codex and Cursor](https://perched.fyi/guides/agent-compatibility/): Compare Perch support for Claude Code, Codex CLI and Cursor local Agent: status, approvals, questions, plans, replies and navigation limits.
- [Approve, answer and reply from Perch](https://perched.fyi/guides/answering-agents/): Learn Perch’s opt-in answering workflow, supported provider actions, two-second undo and handoff back to the agent’s own app.
- [Perch keyboard shortcuts and the review loop](https://perched.fyi/guides/keyboard-shortcuts/): Open Perch with Control-Option-C, navigate sessions and use Return, number keys and Esc for supported answers and the two-second undo.
- [What Perch stores and which permissions it needs](https://perched.fyi/guides/privacy-and-permissions/): Understand Perch’s local status storage, in-memory requests and optional Automation permission. No screen recording, microphone or Accessibility.
- [What to check when agent status is not updating](https://perched.fyi/guides/agent-status-not-updating/): Check Perch’s connection, new sessions, hidden sessions and provider limits when activity or an expected request does not appear.
- [Keep the next prompt beside your coding agents](https://perched.fyi/guides/sticky-notes/): Use Perch’s ten local sticky notes for follow-up prompts, acceptance criteria and review reminders, then copy them into your coding workflow.