문제 해결 및 FAQ

에이전트가 시작되지 않습니다

• 터미널을 열고 에이전트의 CLI를 수동으로 실행합니다. 여기서 실패하면 Orca이 아닌 CLI 자체의 인증 또는 설치 문제입니다.
• CLI가 Orca이 보는 PATH에 있는지 확인하세요(설정 → 에이전트 확인).
• 탭에서 Restart(다시 시작) 칩을 사용해 보세요.

Diff 보기가 잘못되었거나 멈춘 것 같습니다.

• diff 도구 모음에서 새로 고침 아이콘을 클릭합니다. Orca은 작업 트리를 다시 읽습니다.
• 외부 git 작업(리베이스, 재설정)은 새로 고침 사이에 시작될 수 있습니다.

워크트리 생성 실패

• 시작 참조를 가져오지 못할 수 있습니다. 저장소에서 터미널을 열고 git fetch origin을 실행하세요.
• 대상 디렉터리에 이미 해당 분기에 대한 작업 트리가 있을 수 있습니다. 이를 삭제하거나 새 분기 이름을 선택하세요.

Orca CLI에 “명령을 찾을 수 없습니다”라고 표시됩니다.

설정 → 실험 → CLI에서 CLI를 등록합니다. macOS에서는 ~/.local/bin에 shim을 설치합니다. 쉘의 PATH에 있는지 확인하세요.

브라우저에 browser_no_tab이라고 표시됩니다.

현재 작업 트리에 열려 있는 탭이 없습니다. orca tab create --url ...로 열거나 수동으로 브라우저 창을 열고 탐색하세요.

성능 및 메모리

• 적극적으로 사용하지 않는 작업 트리를 닫습니다. 각 작업 트리는 파일 감시자를 활성 상태로 유지합니다.
• 많은 브라우저 탭이 있는 분할 레이아웃은 RAM을 가장 많이 사용하므로 필요하지 않은 브라우저를 닫습니다.

GitHub PR 패널, 검사 및 Tasks 오류

속도 제한, 잘못된 gh 인증, 누락된 범위 및 저장소 접근 문제는 모두 Source Control(소스 제어)과 PR Checks(PR 검사) 패널에 표시됩니다. 전체 오류 분류표와 설정의 GitHub API Budget(GitHub API 예산) 수치가 정상인데도 REST가 차단될 수 있는 이유는 **GitHub 오류 문제 해결**을 참조합니다.

빠른 확인:

gh auth status -h github.com
gh api user
gh api rate_limit --jq '.resources.core'

로그

Help → Open Logs(도움말 → 로그 열기)는 Orca의 로그가 있는 디렉터리를 엽니다. 버그를 신고할 때 이를 첨부하세요.

문제 보고

• GitHub 문제 — 버그 및 기능 요청.
• Discord — 실시간 도움을 드립니다.