文档 / 智能体 / 智能体钩子与记忆

Orca 与 Claude Code 和 Codex 已使用的代理钩子及记忆约定配合良好——它会读取并遵循这些约定，并为在 IDE 上下文中合理的部分提供 UI。

按仓库的钩子¶

Orca 会读取每个仓库的 .claude/ 和 .codex/ 配置。你已有的钩子会在 Orca 于该仓库的工作树中启动代理时运行。

工作树设置钩子¶

配置在工作树创建后自动运行的命令——例如 pnpm install、direnv allow，或用于恢复 .env 文件的脚本。在设置 → 仓库 → 钩子下设置它们。

记忆文件¶

Claude 的 CLAUDE.md 和 Codex 的 AGENTS.md（位于仓库根目录或嵌套目录中）保持原样——它们属于代理。Orca 会在文件资源管理器中像其他文件一样显示它们，以便你进行内联编辑。

代理状态钩子¶

设置 → 代理 → 代理状态钩子 控制 Orca 管理的钩子，这些钩子会将工作中 / 等待中 / 已完成状态报告到 UI。关闭该设置会移除这些受管钩子并停止重新安装它们；重新开启后会恢复它们，无需重启 Orca（在 Windows 上，WSL 钩子中继遵循相同的实时门控）。CLI 等效命令：orca agent hooks status|on|off --json。

重启后保持可用¶

钩子端点会写入磁盘（POSIX 上为 {userData}/agent-hooks/endpoint.env，Windows 上为 endpoint.cmd），并在每次钩子调用时重新加载，因此长期运行的代理会话即使在应用重启后也能继续访问实时 Orca 服务器——不会再出现来自比前一会话存活更久的 PTY 的失效端口 POST 请求。

Orca CLI 暴露了一个带注释的工作树状态字段，代理可以自行更新它。参见 工作树 检查点。