원문 캡처 · github.com
원문 캡처 · github.com

ai-disk-cleanup은 Claude Code, Cursor, Codex 등 AI 코딩 에이전트에 붙여 넣어 디스크 사용량을 점검하고 정리 후보를 분류하는 프롬프트다. macOS, Linux, Windows에서 사용할 수 있으며, 파일을 삭제하기 전에 사용자의 승인을 받도록 설계됐다. GitHub 저장소

사용하려면 원하는 언어의 프롬프트 파일을 열고 --- 아래 내용을 에이전트에 붙여 넣는다. 에이전트가 정리 등급을 물으면 답하고, 관리자 권한이 필요한 명령은 직접 실행한다. 프롬프트 언어는 에이전트의 보고 언어도 지정하지만 셸 명령은 모든 번역에서 영어로 유지된다.

프롬프트는 디스크를 위에서 아래로 살펴 실제 용량을 차지하는 항목을 찾고, 정리 후보를 위험도에 따라 세 등급으로 나눈다. 캐시·빌드 결과물·패키지 다운로드·사용하지 않는 Git 작업 트리는 재생성 가능한 1등급, 가상 머신 디스크·오래된 SDK 런타임·컨테이너 이미지는 내부 데이터가 사라질 수 있는 2등급, 다운로드 폴더·브라우저 프로필·사용하지 않는 앱은 사용자 판단에 맡기는 3등급이다. 단계별로 확보한 공간을 출력하고, rm -rf 대신 각 도구의 자체 정리 명령을 사용하도록 지시한다. sudo나 관리자 권한이 필요한 작업은 우회하지 않고 실행할 명령을 사용자에게 돌려준다.

다만 승인 요청은 프롬프트의 지시일 뿐, 프롬프트 자체가 정지를 강제하지는 않는다. 도구 호출 때 사용자가 확인하는 권한 모드에서 실행해야 한다. 자동 승인 모드로 실행하면 등급별 목록을 보기 전에 파일이 삭제될 수 있다. 보고된 용량이나 무엇이 재생성 가능한지에 대한 판단도 틀릴 수 있으므로 등급표를 검토해야 한다. 삭제 명령은 파일을 휴지통으로 옮기지 않으며 되돌릴 수 없다. 시작 전, 특히 2·3등급 항목을 승인하기 전에 믿을 수 있는 백업을 준비해야 한다.

저장소의 설명에 따르면 macOS에서 494GB 디스크가 99% 차고 여유 공간이 5.2GB인 사례에서 여러 항목을 정리해 약 111GB를 확보했고, 여유 공간은 117GB로 늘었다. 설명에는 루트 소유 항목 두 개를 강제로 처리하지 않고 sudo 명령으로 사용자에게 넘겼다고 적혀 있다. 이는 저장소가 소개한 한 차례의 실행 사례다.

개발자는 발견된 파일과 폴더의 내용을 지시가 아닌 데이터로 취급하도록 프롬프트를 구성했다. 파일 이름이나 다운로드 폴더 안의 README가 에이전트에게 추가 삭제를 지시하지 못하게 하며, sudo 우회도 금지한다. 문제가 발생해 프롬프트가 지정하지 않은 항목을 삭제하면 실행을 중단하고 이슈를 등록하라고 안내한다.