화면 둘러보기

마지막 수정 2026-08-21

Ocul-PM 은 화면이 많아 보이지만, 실은 두 덩어리입니다. 위쪽 「기록」은 에이전트가 무엇을 했는지 쌓이는 곳이고, 아래쪽 「도구」는 그 기록 옆에서 코드를 뒤지고 돌려보는 곳입니다.

사이드바 순서 = ⌘ 번호 순서입니다. 앞 10개에만 번호가 붙습니다.

기록

일지와 플래너는 이 앱의 두 기둥입니다 — 각각 작업 일지와 플래너에서 자세히 다룹니다.

도구

코드 검색 — 세 모드의 차이

의미 검색의 인덱싱은 전부 로컬입니다 — 코드가 밖으로 나가지 않습니다. 프로젝트를 처음 열 때 한 번 인덱싱하고, 그 뒤로는 바뀐 파일만 갱신합니다. 기본값은 코드만 훑지만 「문서 포함」을 켜면 .md·.txt 도 결과에 들어옵니다.

코드 맵 — 무엇에 쓰나

파일과 심볼이 서로 무엇을 부르는지 그린 그래프입니다. 세 가지 쓸모가 있습니다:

• 처음 보는 저장소 파악 — 덩어리(모듈)가 자동으로 묶여 보입니다
• 호출 관계 추적 — 한 파일이 실제로 어떤 함수를 부르는지 심볼 단위로
• 변경 영향 범위 — 지금 고친 파일에서 거꾸로 타고 올라가 "이걸 바꾸면 어디가 흔들리나"

문서 — 저장소의 ./docs 읽기

프로젝트 루트에 docs/ 폴더가 있으면 그 안의 마크다운을 위키처럼 탐색하며 읽습니다. 문서끼리의 상대 링크를 따라가고, 이미지도 그려집니다. 읽기 전용입니다 — 고치는 건 코드 화면이나 평소 쓰는 에디터로.

폴더가 없으면 만들라고 안내만 뜹니다. 설계 문서를 저장소에 두는 팀이면 앱을 나가지 않고 볼 수 있습니다.

문제 해결 (토의)

일지가 회고고 플래너가 현재 계획이라면, 토의는 결정 직전입니다. 옵션 A·B·C 를 늘어놓고 장단점을 적어 고르는 문서고, .oculpm/discussion/<이름>/discussion.md 에 남습니다.

다음 걸음

• 일지가 어떻게 생겼고 무엇을 담는지 → 작업 일지
• 계획이 스스로 갱신된다는 게 무슨 뜻인지 → 플래너
• 단축키 전체 목록 → 단축키