Устранение неполадок и вопросы
Решение распространённых проблем с агентами, worktree, GitHub, CLI и браузером.
Агент не запускается
- Запустите CLI агента вручную в терминале. Если он не работает там, проблема связана с установкой или авторизацией, а не с Orca.
- Убедитесь, что CLI находится в доступном Orca
PATH, и проверьте Настройки → Агенты. - Нажмите Перезапустить на вкладке.
Diff не обновляется или выглядит неправильно
- Нажмите кнопку обновления на панели diff.
- Если rebase, reset или другая операция Git выполнялась вне Orca, обновите diff после её завершения.
Не создаётся worktree
- Исходная ссылка могла быть не загружена. Выполните
git fetch origin. - Для ветки уже может существовать worktree. Удалите его или выберите другое название ветки.
Orca CLI сообщает command not found
Зарегистрируйте CLI в разделе Настройки → Экспериментальные функции → CLI. В macOS Orca устанавливает прокладку в ~/.local/bin; этот каталог должен входить в PATH.
Браузер сообщает browser_no_tab
В текущем worktree нет вкладки браузера. Выполните orca tab create --url ... или откройте панель браузера вручную.
Производительность и память
- Закрывайте неиспользуемые worktree: каждый поддерживает наблюдатели файлов.
- Больше всего памяти занимают разделённые панели с множеством вкладок браузера.
Ошибки GitHub
Лимиты, авторизация gh, недостающие разрешения и доступ к репозиторию влияют на управление версиями и проверки pull request. Полная таблица приведена в статье Ошибки GitHub.
gh auth status -h github.com
gh api user
gh api rate_limit --jq '.resources.core'Журналы
Команда Справка → Открыть журналы показывает каталог журналов Orca. Прикладывайте их к отчёту об ошибке.
Сообщить о проблеме
- GitHub Issues: ошибки и предложения.
- Discord: помощь в реальном времени.
Частые вопросы
Что проверить, если агент не запускается?
Убедитесь, что команда установлена, доступна в PATH Orca и успешно работает в обычном терминале под тем же пользователем.
Почему worktree не создаётся?
Проверьте состояние Git, доступ к репозиторию, допустимость имени ветки и наличие свободного места.
Что делать, если встроенный браузер не открывает локальный сайт?
Проверьте, запущен ли сервер разработки, какой порт он слушает и доступен ли адрес из текущего окружения.
Как диагностировать ошибку Orca CLI?
Сначала выполните команду статуса, затем повторите действие с подробным выводом и сохраните безопасный текст ошибки.
Какие данные приложить к обращению?
Нужны версия Orca, система, шаги воспроизведения и сообщение об ошибке без секретов, токенов и закрытого кода.