문제 해결

마지막 수정 2026-08-16

일지가 안 쌓여요

순서대로 확인하세요:

추적 중인 프로젝트인가요? 프로젝트 루트에 .oculpm/ 폴더와 AGENTS.md 가 있어야 합니다. 없다면 시작 화면에서 폴더를 다시 불러오세요.
터미널 Claude Code 인가요? AGENTS.md 만으로는 모델이 기록을 잊을 수 있습니다. 플러그인(훅 브리지)을 설치하면 자동이 됩니다.
규칙이 오래됐나요? 설정 → ocul-pm → 에이전트 탭에서 규칙 다시 보내기로 AGENTS.md 를 최신 규격으로 갱신할 수 있습니다.
다른 에이전트(Cursor 등)인가요? 설정에서 해당 에이전트의 규칙 파일을 켜야 합니다. AGENTS.md 를 읽는 에이전트라면 그대로 동작합니다.

정상입니다 — ACP 프로토콜은 CLI 의 대화형 명령을 나르지 못합니다. Claude Code 화면 우상단 터미널 버튼으로 진짜 claude 를 열어 거기서 실행하세요. 자세한 이유는 Claude Code 연동에.

첫 실행에만 어댑터를 자동 설치합니다 (npm, 고정 버전 — 수 분). 그 뒤로는 바로 붙습니다. 상태는 설정 → ocul-pm → 연동에서 확인할 수 있습니다.

앱에는 로그인 화면이 없습니다 — 어댑터가 인증 흐름을 제공하지 않아서입니다. 터미널에서 claude 를 실행해 한 번 로그인하면, 앱이 그 자격을 그대로 씁니다.

에이전트가 승인 대기로 멈추면 사이드바 Claude Code 줄에 깜빡이는 배지가 붙습니다 (v2.11). 다른 화면에 있어도 보입니다. 승인 카드에는 실행될 명령·바뀔 내용이 그대로 실려 있으니 읽고 누르면 됩니다.

Claude Code 화면 툴바의 계기가 오늘 · 주간 · 모델별 사용률을 보여 줍니다. 누르면 초기화 시각까지 나오고, /usage 를 입력해도 같은 위젯이 열립니다. 이 조회는 토큰을 쓰지 않습니다.

업데이트 재시작은 앱과 함께 어댑터 프로세스도 새로 띄웁니다. 대화 자체는 디스크에 있어 그대로 돌아오지만, 재시작 순간에 흐르고 있던 답변 하나는 잃습니다. 그래서 앱은 답변이 도는 동안에는 업데이트 재시작을 미룹니다.

드물게 어댑터가 종료되면 배너가 뜹니다 (v2.11). 「다시 연결」을 누르면 어댑터를 다시 띄우고 보던 대화를 그대로 되살립니다.

처음 한 번은 로컬 임베딩 모델을 내려받고 프로젝트를 인덱싱합니다. 이후에는 변경분만 갱신해서 빠릅니다. 전부 로컬 계산이라 코드는 밖으로 나가지 않습니다.

한 마디도 하지 않은 새 대화는 목록에 실리지 않습니다 — 첫 마디를 보내는 순간 진짜 세션이 만들어지고 목록에 나타납니다.

GitHub 이슈로 알려 주세요. 설정 → 진단의 정보를 함께 붙이면 빠르게 잡을 수 있습니다.