사용법 · FAQ

설치

macOS

1. 다운로드한 zip을 풀고 io-sweep.app을 응용 프로그램 폴더로 옮깁니다.
2. 처음 열 때 "확인되지 않은 개발자" 경고가 뜨면, 앱을 우클릭 → 열기를 누르세요. 공증된 버전은 경고 없이 열립니다.

Windows

1. 다운로드한 exe를 원하는 위치에 두고 실행합니다. 설치 과정이 없습니다.
2. SmartScreen 경고가 뜨면 "추가 정보" → "실행"을 누르세요. Microsoft Store 버전은 경고가 없습니다.

기본 사용법

1. + 추가로 프로젝트들이 모여 있는 상위 폴더를 즐겨찾기에 넣습니다. 예: ~/Projects, D:\work
2. 스캔을 누르면 프로젝트별 정리 후보가 표 형태로 나옵니다.
3. 전체·안전·주의 탭으로 걸러 보고, 체크한 뒤 휴지통으로 이동을 누릅니다. 하단에 선택 개수와 예상 확보 용량이 보입니다.
4. 영구 삭제는 휴지통을 거치지 않으니 되돌릴 수 없습니다. 꼭 필요할 때만 쓰세요.

제외 목록

지우고 싶지 않은 폴더가 있으면 즐겨찾기 루트나 프로젝트 폴더에 .project-cleaner-ignore 파일을 두고 한 줄에 하나씩 glob 패턴을 적습니다.

# 보존할 것
keep-*
archive/**
web/dist

자주 묻는 질문

지운 폴더는 어떻게 되돌리나요?

휴지통으로 이동했다면 휴지통에서 복원하면 됩니다. 영구 삭제한 것은 복구할 수 없습니다.

node_modules를 지우면 프로젝트가 망가지나요?

아니요. 다음에 npm install을 한 번 실행하면 그대로 돌아옵니다. 설치 시간만 다시 듭니다.

스캔 결과가 전부 "주의"로 나와요.

현재 버전은 보수적으로 판정합니다. 다음 업데이트에서 node_modules처럼 명령 한 번으로 복구되는 폴더는 "안전"으로 분류할 예정입니다.

특정 프로젝트가 안 잡혀요.

프로젝트 표시 파일(package.json, pubspec.yaml 등)이 같은 폴더에 있어야 후보로 봅니다. 설정의 검색 깊이(기본 12)도 확인하세요.

내 파일 목록이 서버로 가나요?

아니요. 스캔과 정리는 전부 컴퓨터 안에서 끝납니다. 개인정보처리방침을 보세요.