문서

판이 프로젝트를 찾는 방법, 그리고 어떤 폴더가 뜨지 않는 이유.

Philote 가 프로젝트를 찾는 방법

1. Claude Code(터미널이나 VS Code)나 Codex 를 시작하면, Philote 가 그 세션과 세션이 도는 폴더를 기록합니다. ChatGPT 앱의 Codex 는 앱이 남기는 세션 파일에서 찾습니다.
2. 세션마다 프로젝트 폴더가 하나 정해집니다. 이미 추가한 폴더(그 안의 하위 폴더 포함)가 먼저이고, 아니면 그 Git 저장소의 맨 위 폴더, 그것도 아니면 AI 를 시작한 폴더입니다.
3. 추가한 폴더는 판의 칸이 됩니다. AI 가 돈 새 폴더는 추가하거나 무시할 때까지 판 머리글의 새 폴더와 판의 빈자리에 제안됩니다. 새 폴더를 바로 추가하려면 설정 › 동작 › 새 폴더를 바로 프로젝트로 추가를 켜세요.

제안하지 않는 폴더

이 폴더들에서도 AI 세션은 그대로 돕니다. Philote 가 폴더를 제안하지 않을 뿐이라, 직접 추가하기 전에는 판에 뜨지 않습니다.

• 임시 폴더와 그 안의 모든 폴더: /tmp, /private/tmp, /var/tmp, /var/folders, 그리고 홈 폴더의 ~/tmp, ~/temp, ~/Temp, ~/.Trash, ~/Library/Caches. 예를 들어 ~/tmp/my-app 의 프로젝트는 제안하지 않습니다.
• 홈 폴더 자체와 그 위. ~ 에서 바로 시작한 세션은 아예 기록하지 않으니, 프로젝트 폴더 안에서 AI 를 여세요.
• 무시한 폴더. 설정 › 프로젝트 › 무시한 폴더 › 무시 해제로 되돌립니다.

직접 추가하기

판 머리글의 + 폴더 추가를 눌러 폴더를 고르세요. 직접 추가한 폴더는 ~/tmp 같은 임시 폴더 안에 있어도 늘 뜨고, 거기서 도는 세션이 그 칸에 보입니다.

또는 프로젝트를 임시 폴더 밖, 예를 들어 ~/projects 로 옮기면 다른 폴더처럼 제안됩니다.

그래도 뜨지 않으면

알려 주시면 살펴보겠습니다 — 지원