프로젝트 소개

TidyMyMac은 개발자를 대상으로 하는 오픈소스 macOS 저장 공간 정리 유틸리티입니다. 터미널에서 디스크 공간을 스캔, 검토 및 확보하며, 투명성과 안전성을 설계 목표로 합니다: 먼저 검사하고, 삭제 전에 검토하며, 기본적으로 드라이런(dry-run)을 수행하고, 터미널 네이티브로 유지합니다. README에 나열된 기능에는 정리할 항목을 탐색하고 선택하기 위한 대화형 TUI, 검토 화면에서 항목별 선택(단일 다운로드, Docker 이미지/컨테이너/볼륨, iOS 백업 또는 Time Machine 스냅샷을 해당 실행에서 선택 해제), 슬래시 필터 및 전체 선택/해제, 기본 드라이런, 어떤 플래그에도 관계없이 어떤 클리너도 건드릴 수 없는 보호 경로, 모듈식 클리너, 카테고리와 프로젝트 디렉토리를 묶는 명명된 프로필, 진행 상황 보고 및 확보된 공간 요약, 스캔 결과의 JSON 또는 CSV 내보내기, 셸 정리 스크립트 생성, 모든 명령에서 특정 카테고리 지정이 포함됩니다. README는 macOS가 캐시, 개발자 아티팩트, 로그 및 모호한 시스템 데이터 카테고리와 같이 검사하기 어려운 위치에 저장 공간을 축적한다는 점을 언급하며 이 도구의 필요성을 설명합니다. 클리너가 다루는 항목: 임시 파일(/tmp, /var/tmp, 사용자 임시 디렉토리); 애플리케이션 캐시(~/Library/Caches); 시스템 로그(~/Library/Logs, /Library/Logs, /var/log); Homebrew 캐시; Docker 아티팩트(중지된 컨테이너, 태그 없는 이미지, 고아 볼륨); iOS 백업; 오래된 macOS 업데이트 잔여물 및 설치 프로그램; 설치 파일(.dmg, .pkg) 및 ~/Downloads의 대용량 항목; 제거된 앱의 앱 고아 파일; Xcode DerivedData, 아카이브 및 시뮬레이터; Go 빌드 및 모듈 캐시; node_modules, dist, target 및 .venv와 같은 프로젝트 아티팩트 및 프로필 프로젝트 경로에서 500MB 이상의 파일; 로컬 Time Machine 스냅샷; 휴지통. 문서화된 설치 옵션은 curl 설치 스크립트(/usr/local/bin에 설치, $HOME/.local/bin으로 대체, sudo 프롬프트 포함), Homebrew 탭, go install, make build를 사용한 소스 빌드입니다. README는 Go 1.26+가 필요하다고 명시합니다. 사용법은 명령을 중심으로 합니다: scan(기본적으로 대화형 테이블, 카테고리 선택, 프로필 스캔, JSON/CSV/테이블 출력, 상세 출력, --print-all, --save, --generate-script, --quiet); clean(기본 드라이런, 삭제하려면 --execute, 카테고리 또는 프로필 선택, --include-large-files, --from-file, JSON 출력, --prompt-sudo); profile(create, add-category, add-path, list, remove-path, delete); protect/unprotect 및 보호 목록 표시; 버전, explain, 카테고리 목록 및 기록. 안전 참고 사항: 기본 드라이런, --execute로만 삭제, CLI 플래그로 재정의할 수 없는 하드 블록인 보호 경로, 구성 파일이 없어도 AI 모델 저장소(~/.ollama/models 및 ~/.cache/huggingface)에 대한 기본 제공 보호, 자동 작업 없음, 치명적이지 않은 오류. 구성은 선택적 ~/.tidymymac/config.yaml에 있으며 보호 경로, 기본적으로 비활성화된 카테고리 및 프로필을 다룹니다. 문제 해결 문서는 macOS에서 터미널에 전체 디스크 액세스 권한이 없으면 휴지통 및 일부 카테고리가 0B로 보고될 수 있다고 언급합니다. 이 프로젝트는 MIT 라이선스입니다.