문제 해결

Docnest는 작업에 방해되지 않게 조용히 숨어 지냅니다. 가끔은 너무 잘 숨어서 탈입니다. 지금 겪는 일을 아래에서 찾아보십시오.

메뉴 막대에 Docnest 아이콘이 보이지 않습니다

아이콘이 안 보인다면 대개 노치 뒤에 숨어 있습니다. 노치가 있는 MacBook은 메뉴 막대에 자리가 모자라면 남는 아이콘을 노치 뒤로 보냅니다. macOS가 따로 알려 주지도 않습니다. 메뉴 막대 앱을 많이 쓸수록 자주 생기는 일입니다.

아이콘 없이 Docnest 열기

화면 가장자리(바꾸지 않았다면 오른쪽)에 마우스를 대면 사이드 선반이 열립니다. 설정은 선반의 선반 옵션(…) → 설정…에서 열면 됩니다. 수집창 표시가 상단과 사이드(기본)나 사이드만일 때 쓸 수 있는 방법입니다.

아이콘 자리 만들기

쓰지 않는 메뉴 막대 앱을 종료하거나 메뉴 막대 관리 앱으로 숨깁니다.
아이콘이 다시 보이면 ⌘를 누른 채 Docnest 아이콘을 오른쪽으로 끌어 둡니다. 그러면 다른 아이콘이 늘어나도 덜 가려집니다.
macOS 26에서는 시스템 설정 → 메뉴 막대에서 Docnest가 허용되어 있는지 확인합니다.

상단만을 골라 둔 상태에서 아이콘이 가려졌다면 메뉴 막대에 자리를 만드는 것 말고는 열 방법이 없습니다. 연 뒤에는 설정 → 표시 → 수집창 표시를 상단과 사이드로 바꿔 두십시오. 다음에 아이콘이 가려져도 사이드 선반으로 열 수 있습니다.

새 문서가 보이지 않습니다

아래 순서대로 확인합니다.

설치 전에 만든 파일은 모으지 않습니다. Docnest는 설치한 뒤에 에이전트가 쓴 문서부터 모읍니다. 그 전 파일은 검토에 올리지 않습니다.
꺼진 형식은 모으지 않습니다. 문서·플랜·이미지는 기본으로 켜져 있고 PDF와 코드 파일 등은 꺼져 있습니다. 설정 → 수집 → 형식에서 확인합니다. 꺼진 형식의 파일이 생기면 선반의 수집 제안으로 알려 주며, 거기서 바로 모으기를 고를 수 있습니다.
따로 연결해야 하는 도구가 있습니다. Cursor, Windsurf 같은 도구는 설정 → 연결과 통합에서 연결해야 합니다. 확인 필요나 연결 미확인으로 표시된 도구는 다시 연결해 봅니다. 도구 목록은 지원하는 AI 도구에 있습니다.
임시 폴더의 문서는 기본으로 모으지 않습니다. /tmp 같은 임시 폴더에 쓴 문서는 선반의 제안에서 모으기를 고르거나 설정 → 수집의 임시 폴더의 AI 문서도 수집을 켜야 모입니다. 모으지 않아도 에이전트 대화 안에서는 읽을 수 있습니다.
수집 테스트로 Docnest를 확인합니다. 설정 → 수집 → 문서 수집 테스트에서 테스트 문서 만들기 옆의 테스트 실행을 누르면 첫 번째 프로젝트 폴더에 Markdown 파일 하나와 수정 버전 두 개를 만듭니다. 이 문서가 선반에 나타나면 Docnest 쪽은 정상이니 AI 도구 쪽 설정을 살펴봐야 합니다.
새로고침합니다. 메뉴 막대 아이콘을 오른쪽 클릭하고 지금 새로고침을 고릅니다.

문서를 쓴 AI가 틀리거나 ‘미상’으로 나옵니다

Docnest는 세션 기록을 읽을 수 있어야 어떤 AI가 문서를 썼는지 압니다. 설정 → 수집 → 수집 방식에서 에이전트 세션 기록에서 수집을 켜 두십시오. 프로젝트 폴더를 지켜보다 찾은 문서는 출처를 추정하거나 ‘미상’으로 표시합니다.

대화 탭이 흐리게 보입니다

설정 → 에이전트 대화에서 에이전트 대화 보기를 켜고, 세션 기록 읽기도 허용해야 합니다. 두 설정은 에이전트 대화에서 자세히 다룹니다.

권한 요청

Docnest는 기능에 필요한 권한만 요청합니다.

macOS가 묻는 권한	언제	바꾸는 곳
파일 및 폴더(데스크탑, 문서, iCloud Drive, 외장 드라이브)	프로젝트가 보호된 폴더에 있을 때	시스템 설정 → 개인정보 보호 및 보안 → 파일 및 폴더
알림	macOS 알림 센터에 표시를 켤 때	설정 → 알림과 소리 → 권한 요청 또는 시스템 설정
자동화(터미널, iTerm 등)	세션을 터미널에서 열 때. Docnest가 해당 탭을 고릅니다	시스템 설정 → 개인정보 보호 및 보안 → 자동화
다운로드 폴더	다운로드 AI 받은편지함을 켤 때	시스템 설정 → 개인정보 보호 및 보안 → 파일 및 폴더
로그인 항목	로그인할 때 실행을 켤 때	시스템 설정 → 일반 → 로그인 항목

실수로 허용 안 함을 눌렀다면 위 표의 위치에서 Docnest를 허용한 뒤 앱을 종료했다가 다시 엽니다.

원하지 않을 때 선반이 열립니다

새 문서가 오면 선반 펼치기(알림과 소리)를 끄면 작은 알림만 나타납니다.
작업 중에는 자동 확장 줄이기(일반)가 켜져 있는지 확인합니다. 켜져 있으면(기본값) Codex·Claude·Cursor 앱이 앞에 있을 때 선반이 펼쳐지지 않습니다.
전체 화면에서는 숨기기(일반)를 켭니다.
마우스를 올려 열기(표시)의 대기 시간을 늘립니다.

그래도 해결되지 않으면

여기까지 해 봐도 그대로라면 이제 저희가 살펴볼 차례입니다.

설정 → 고급 → 진단에서 진단 복사를 누릅니다. 진단에는 연결 상태와 개수 같은 정보가 담깁니다. 문서 내용, 대화, 토큰, 원문 세션 ID, 인증 정보는 담기지 않습니다.
진단 내용을 붙여 버그를 제보하거나 이메일로 보내 주십시오.