# Glossary

Canonical: https://perched.fyi/glossary/

Short definitions with the context that matters in a Perch workflow, and a useful next step for each term.

- [What is an agent hook?](https://perched.fyi/glossary/agent-hook/): An agent hook is an event-triggered integration point. Learn how Perch uses local hooks to receive activity without reading your terminal screen.
- [What is a coding-agent session?](https://perched.fyi/glossary/agent-session/): A coding-agent session is a particular ongoing interaction with an agent. Understand sessions, turns and Perch’s working, waiting and recent states.
- [What does human-in-the-loop mean for coding agents?](https://perched.fyi/glossary/human-in-the-loop/): Human-in-the-loop means a person makes a decision in an automated workflow. In Perch, you review and choose each supported agent response.
- [What does local-first mean for Perch?](https://perched.fyi/glossary/local-first/): For Perch, local-first means the app keeps activity and notes on your Mac and makes no network requests. Agent provider processing remains separate.
- [What is a coding-agent tool approval?](https://perched.fyi/glossary/tool-approval/): A tool approval is your decision about a proposed agent action. Learn the difference between approving a tool, a plan and a completed result.
- [What is context switching in an agent workflow?](https://perched.fyi/glossary/context-switching/): Context switching means moving attention between tasks or apps. Distinguish checking agent state from the focused work of reviewing its result.