Хуки и память агентов
Работа Orca с хуками репозитория, настройкой worktree и файлами памяти агентов.
Orca читает хуки и файлы памяти Claude Code и Codex в формате, который используют сами агенты. Настройки репозитория продолжают действовать внутри каждого worktree.
Хуки репозитория
Orca читает конфигурацию .claude/ и .codex/ в каждом репозитории. Существующие хуки запускаются, когда Orca открывает агента в worktree этого репозитория.
Хуки настройки worktree
Можно автоматически выполнять команды после создания worktree, например pnpm install, direnv allow или сценарий восстановления файлов .env. Настройка находится в разделе Настройки → Репозиторий → Хуки.
Файлы памяти
Orca не изменяет файлы CLAUDE.md для Claude и AGENTS.md для Codex, расположенные в корне репозитория или вложенных каталогах. Они принадлежат агентам. Orca показывает их в проводнике вместе с остальными файлами и позволяет редактировать во встроенном редакторе.
Работа после перезапуска
Адреса хуков записываются на диск: {userData}/agent-hooks/endpoint.env в POSIX-системах и endpoint.cmd в Windows. При каждом вызове хука файл подключается заново. Поэтому длительные сессии агентов продолжают обращаться к действующему серверу Orca даже после перезапуска приложения, а старый PTY не отправляет POST-запросы на закрытый порт.
В Orca CLI есть комментируемое поле состояния worktree, которое агенты могут обновлять самостоятельно. Подробнее: Контрольные точки worktree.
Частые вопросы
Какие хуки учитывает Orca при создании worktree?
Orca может запускать настроенные действия проекта, которые подготавливают новый worktree к работе агента.
Зачем нужны хуки настройки worktree?
Они помогают повторяемо установить зависимости, создать локальные файлы и выполнить другую подготовку для каждой задачи.
Что считается памятью агента?
Это файлы с инструкциями и контекстом проекта, которые поддерживаемый агент читает перед выполнением задачи.
Нужно ли хранить секреты в файлах памяти?
Нет. В инструкции агента и репозиторий нельзя добавлять токены, пароли и другие закрытые данные.
Как проверить, что хук выполнился правильно?
Откройте журнал терминала нового worktree и убедитесь, что подготовительные команды завершились без ошибки.