개요
Mole은 같은 정리 범위, 안전 규칙, 보호 목록을 쓰는 두 가지 인터페이스입니다. CLI는 무료 오픈 소스이며 MIT 라이선스입니다. Mac 앱은 네이티브 SwiftUI 앱이며 얼리버드 가격은 2026년 6월 15일까지 $9, 6월 16일부터 정식 일회성 가격은 $19입니다. Mac 워크플로는 네이티브 실행을 사용하고, CLI에는 터미널 전용 명령이 추가됩니다.
Mac 앱
설치
홈페이지에서 DMG를 내려받거나 Homebrew로 설치하세요: brew install --cask mole-app.
정리 (지구)
10가지 카테고리를 스캔합니다: 앱 캐시, 시스템 캐시와 로그, 개발자 도구(Xcode, npm, pip, Gradle), AI 도구(ChatGPT, Claude, Codex, Copilot, Cursor, Antigravity), 브라우저(Chrome, Edge, Arc, Safari, Firefox), 클라우드 스토리지 클라이언트, 디자인 도구(Adobe, Figma, Sketch), 커뮤니케이션 앱(Slack, Discord, WeChat, Zoom), 기타 임시 파일. 휴지통은 목록 맨 끝에 별도로 표시됩니다.
검토 목록은 삭제 영향도순으로 정렬됩니다: 재생성 가능한 캐시가 먼저, 사용자 가시 상태가 마지막, 휴지통은 항상 맨 아래. 하드링크 인식 크기 측정으로 여러 도구가 공유하는 파일(uv, pnpm)은 중복 계산되지 않습니다. 기본 삭제는 영구 삭제이므로 확보된 용량이 표시 수치와 일치합니다. 설정에서 시스템 휴지통 경유로 전환할 수 있습니다.
기본 검토 전용 항목은 재구성 비용이 큰 패키지 캐시(npm, yarn, pnpm, bun, CocoaPods, Gradle, Maven)와 일반적인 프로젝트 산출물(build, dist, target, .build, node_modules, venv)입니다. 이런 폴더는 클 수 있어 확인 전까지 선택되지 않습니다. 자동 정리 항목은 미리 선택되며, 복구 가능한 안전망은 설정에서 휴지통 모드로 바꿀 수 있습니다.
Software (Mars)
Software는 앱 업데이트, 시작 항목 관리, 제거 후 정리를 함께 다룹니다. Updates 보기는 Sparkle, Homebrew Cask / Formula, Mac App Store 앱을 확인하고, 지원되는 업데이트는 앱 안에서 설치합니다. macOS가 요구하는 경우 App Store 이동을 명확히 안내합니다.
Startup 보기는 Login Items, Launch Agents, Launch Daemons, 백그라운드 항목을 나열합니다. 지원되는 항목은 비활성화하거나 파일 위치를 표시할 수 있고, Apple 관리 항목은 시스템 설정으로 안내합니다.
제거할 앱을 선택하면 Mole은 Application Support, Caches, Preferences, Logs, Launch Agents, Launch Daemons, Login Items, Containers, Group Containers, Saved Application State, Input Methods 등 15개 이상의 Library 하위 디렉터리에서 잔여 파일을 찾습니다. Dock 항목은 자동으로 정리되며 개인 데이터로 보이는 항목은 삭제 전에 경고합니다.
업데이트는 가능한 한 앱 안에서 진행됩니다: Sparkle과 Homebrew Cask는 Mole 안에서 직접 설치하고, Mac App Store는 CommerceKit을 거치며 인증이나 시간 초과가 발생하면 App Store 앱으로 폴백합니다. 그 외 앱은 자체 업데이터가 이어받도록 앱이 열립니다. Cmd 클릭으로 여러 앱을 한 배치에 묶어 제거할 수 있고, 개별 실패는 재시도를 위해 목록에 남습니다.
/Applications/*.app의 root 소유 번들을 제거할 때는 세션 첫 1회 관리자 인증을 요청하고 이후 같은 세션에서는 다시 묻지 않습니다. Startup 보기에서는 안정적인 launchd 서비스에 매핑할 수 있는 로그인 항목과 검증된 LaunchAgents / LaunchDaemons는 Mole이 직접 전환합니다. macOS 백그라운드 작업 관리에서 명확한 핸들이 없는 항목은 해당 시스템 설정 화면으로 안내합니다.
Optimize (Mercury)
기본 유지보수 작업을 한 번의 탭으로 실행합니다. 비관리자 작업은 조용히 실행되고, 관리자 작업은 필요할 때 한 번의 인증으로 묶입니다.
작업에는 Quick Look, 안전할 때의 Spotlight, 폰트 캐시와 Launch Services 정리, SQLite vacuum, 저장된 앱 상태, 격리 이벤트, 알림 기록, 손상된 환경설정, Launch Agent, 공유 파일 목록, 선택적 Dock 새로고침, 로그인 항목 점검, periodic maintenance가 포함됩니다.
조건이 안전하지 않으면 작업을 건너뜁니다. 브라우저가 열려 있으면 폰트 캐시 재구성을 건너뛰고, 배터리 전원에서는 Spotlight 재인덱싱을 건너뜁니다. DNS 또는 네트워크 스택 재설정은 기본 유지보수 목록에 포함되지 않습니다.
VPN이 활성, 블루투스 HID나 오디오, 외부 디스플레이나 오디오 장치가 감지되면 Optimize는 장치 상태를 건드리는 작업도 자동으로 건너뜁니다. 건너뛴 작업은 결과 패널에 사유가 표시되어 어떤 작업이 실행됐는지 확인할 수 있습니다. Dock 재시작은 7일 쿨다운이 있고 마지막 실행 이후 며칠이 지났는지를 표시하므로, 연이은 실행이 Dock을 흔드는 일이 없습니다.
분석 (목성)
디스크 전체의 트리맵 시각화입니다. 어떤 디렉터리든 들어가서 각 단계의 크기를 확인하세요. 빽빽하거나 비슷한 크기의 항목은 요약 블록으로 묶어 지도를 읽기 쉽게 유지합니다.
크기를 측정할 수 없는 항목(권한 제한 폴더, TCC 제한 컨테이너)은 조용히 생략하지 않고 재시도 옵션과 함께 표시됩니다. 보호된 탐색 루트(/, /Users, /Applications)는 휴지통으로 보낼 수 없습니다. 디스크 스캔 결과는 빠른 재진입을 위해 24시간 캐시됩니다.
트리맵에서 디렉터리를 한 번 클릭하면 안으로 들어가고, 맵 위쪽의 Breadcrumb로 임의의 상위 단계로 되돌아갈 수 있습니다. 왼쪽 목록과 실제 트리맵 블록에는 Finder에서 열거나 표시하는 작업, 우클릭 후 확인을 거쳐 휴지통으로 이동하는 작업이 남아 있습니다. 요약 블록은 개요 전용입니다. 트리맵의 블록 면적은 바이트 크기에 비례하므로 가장 많은 공간을 차지하는 항목이 항상 가장 크게 보입니다.
Status (Sun)
건강 점수, CPU, 메모리, GPU, 디스크 I/O, 네트워크, 배터리, 온도/팬, 가동 시간을 하나의 bento 대시보드에 모읍니다. 각 지표에는 60초 미니 그래프가 있으며, 지원되는 Mac에서는 Auto, Cool, Quiet 팬 제어가 표시됩니다.
아래 프로세스 목록은 매초 갱신됩니다. 열 제목을 클릭해 정렬하고, 행을 클릭해 고정하면 새로고침 후에도 특정 프로세스를 계속 볼 수 있습니다.
다섯 열(이름, PID, CPU, Power, 메모리)이 모두 클릭으로 정렬되며, 다시 한번 클릭하면 오름차순/내림차순이 전환됩니다. 행을 우클릭하면 Pin/고정 해제(새로고침과 앱 재시작에도 유지), Terminate(TERM 후 필요 시 KILL로 폴백), 실행 파일 경로 복사를 선택할 수 있습니다. Battery 타일의 top drain 행은 클릭하면 해당 프로세스 설명 시트로 바로 연결됩니다.
macOS 메뉴 바에 상시 표시할 수 있는 모니터입니다. 실시간 지표, 간단한 아이콘, 또는 시스템 부하를 따라 움직이는 작은 러너를 선택할 수 있습니다. 팝오버에는 하드웨어 카드, 지원되는 경우 팬 제어, 상위 프로세스, Clean Watch 요약이 표시됩니다.
팝오버 하단에는 빠른 도구가 있습니다. 카메라나 마이크 사용 표시, 시간 선택이 가능한 Keep Screen On, 화면을 단색으로 바꿔 디스플레이와 키보드를 닦기 쉽게 하는 Clean Screen(선택적 Accessibility 입력 잠금), 외부 볼륨 꺼내기가 포함됩니다. 우클릭 메뉴와 전역 단축키로 모든 도구를 열 수 있고, Dock 아이콘을 숨기면 메뉴 바 전용 앱처럼 사용할 수 있습니다. Settings → Menu Bar에서 설정합니다.
디스플레이 모드는 러너 애니메이션과 두 줄로 구성된 메트릭 표시 사이에서 전환할 수 있습니다. 두 줄은 각각 CPU, 메모리, 온도, 디스크, 네트워크 중에서 독립적으로 선택할 수 있습니다. 러너 캐릭터(두더지 / 고양이 / 토끼 / 다람쥐)는 단순한 외관 차이일 뿐 샘플링하는 지표를 바꾸지 않습니다.
Doctor
메뉴 바에서: Help -> Run Doctor.... Mole이 Mac 모델, macOS 버전, 권한, 최근 작업, 디스플레이, 외부 볼륨, 네트워크, 보안 상태, 환경에 관한 간단한 진단 보고서를 수집합니다. Copy Report를 클릭해 채팅에 붙여넣거나, Open GitHub Issue를 클릭해 보고서가 미리 채워진 버그 양식으로 이동하세요.
Doctor는 다섯 가지 상태를 감지합니다: 전체 디스크 접근 누락, 높은 메모리 압력, 90% 이상의 디스크 사용량, 기록 불가능한 작업 로그, 최근 작업 실패. 각 상태는 해결 단계가 포함된 도움말 문서로 연결됩니다. 자세한 내용은 도움말 페이지를 참조하세요.
설정
Settings에는 세 개의 탭이 있습니다. General: 인터페이스 언어, 로그인 시 실행, Dock 아이콘 숨기기, 라이선스 활성화와 기기 관리, 전체 디스크 접근 바로가기. Maintenance: 캐시 삭제 방식, 보호 목록, Optimize Dock 새로고침. Menu Bar: 메뉴 바 모니터, 러너와 지표 전환, 표시할 지표, 지원되는 경우 팬 동작, Menu Bar Toggle / Keep Screen On / Clean Screen 단축키를 설정합니다. 라이선스 활성화는 언제든 Cmd + Shift + L로 열 수 있습니다.
CLI
설치
Homebrew: brew install mole. 스크립트: curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash. mo를 실행하면 인터랙티브 메뉴가 나오고, 하위 명령어를 직접 실행할 수도 있습니다.
공유 명령어 (Mac 앱에도 포함)
mo clean
Mac 앱과 동일한 10가지 카테고리를 대상으로 심층 정리합니다. 삭제 없이 미리보기하는 --dry-run, 상세 로그를 위한 --debug, 보호할 캐시를 관리하는 --whitelist를 지원합니다. 실행 중인 앱의 캐시는 자동으로 건너뜁니다.
mo uninstall
잔여 파일 감지가 포함된 인터랙티브 앱 선택입니다. 앱 크기, 번들 ID, 마지막 사용 날짜를 표시합니다. Mac 앱과 동일한 15개 이상의 잔여 카테고리를 찾습니다. --dry-run을 지원합니다.
mo optimize
CLI 유지보수 작업을 실행합니다. 관리자 작업은 비밀번호를 요청합니다. 작업 구성은 Mac 앱의 기본 Optimize 목록과 다를 수 있습니다. --whitelist로 특정 작업을 이후 실행에서 제외할 수 있습니다.
mo analyze
터미널에서 인터랙티브 트리맵을 표시합니다. 화살표 키 또는 Vim 키바인딩(h/j/k/l)으로 탐색합니다. 맵에서 직접 파일을 휴지통에 넣을 수 있습니다. --json 출력과 외장 드라이브를 위한 mo analyze /Volumes 같은 사용자 경로를 지원합니다.
mo status
실시간 시스템 대시보드: CPU, GPU, 메모리, 디스크 I/O, 네트워크, 배터리, 온도, 가동 시간, 건강 점수, 상위 프로세스와 60초 스파크라인. 다른 도구로 파이핑하기 위한 --json을 지원합니다.
CLI 전용 명령어
mo purge
프로젝트 디렉터리의 오래된 빌드 아티팩트를 찾습니다: node_modules, target, .build, build, dist, venv. 설정 가능한 경로(기본: ~/Projects, ~/GitHub, ~/dev)를 스캔합니다. 7일 미만의 프로젝트는 "Recent"로 표시되며 기본적으로 선택 해제됩니다. --dry-run과 스캔 디렉터리를 설정하는 --paths를 지원합니다.
mo installer
다운로드, 데스크톱, Homebrew 캐시, iCloud, 메일 첨부파일에서 .dmg, .pkg, .zip 설치 파일을 찾습니다. 각 파일을 원본 위치별로 라벨링합니다. --dry-run을 지원합니다.
mo touchid
sudo 명령에 Touch ID를 활성화합니다. mo touchid enable로 설정하고 mo touchid disable로 되돌립니다. --dry-run을 지원합니다.
유틸리티 명령어
mo completion
Bash와 Zsh용 셸 탭 자동완성을 설정합니다. 셸을 자동 감지하고 적절한 설정 파일을 업데이트합니다.
mo update
최신 안정 릴리스로 자체 업데이트합니다. --nightly로 main 브랜치의 최신 미공개 빌드를 받을 수 있습니다(스크립트 설치 전용). --force로 현재 버전을 재설치합니다.
mo remove
설정 파일과 셸 연동을 포함하여 Mole CLI를 시스템에서 제거합니다. --dry-run을 지원합니다.
안전성
CLI와 Mac 앱 모두 동일한 안전 원칙을 공유합니다:
경로 보호. 내장된 거부 목록이 시스템 필수 디렉터리, 홈 폴더의 핵심 구조, 알려진 캐시 위치 밖의 모든 경로를 보호합니다. 심볼릭 링크는 작업 전에 해석하고 검증합니다.
프로세스 인식. 실행 중인 앱의 캐시는 정리 시 건너뜁니다. 브라우저가 열려 있는 동안에는 브라우저 캐시를 건드리지 않습니다.
라이선스 게이트. Mac 앱에서는 각 파괴적 도구(정리, 제거, 최적화, 분석에서 휴지통으로 이동)를 2번 무료로 사용할 수 있습니다. 이후에는 활성 라이선스가 필요합니다. 스캔은 항상 무료입니다.
화이트리스트. CLI(~/.config/mole/whitelist)와 Mac 앱 모두 특정 캐시나 최적화 작업을 이후 실행에서 보호할 수 있습니다.
작업 로그. 모든 삭제는 ~/Library/Logs/mole/operations.log에 기록됩니다. Mac 앱의 Doctor 오버레이가 이 로그의 상태를 확인하고 최근 실패를 표시합니다.
미리보기 우선. CLI는 모든 파괴적 명령에 --dry-run을 지원합니다. Mac 앱은 작업 전에 전체 파일 목록과 용량을 보여줍니다.
문제 해결
Mac 앱에는 일반적인 문제를 감지하는 내장 Doctor가 포함되어 있습니다. 메뉴 바에서 Help -> Run Doctor...로 엽니다. 특정 상태에 대해서는 도움말 페이지를 참조하세요.
CLI의 경우 --debug를 추가하면 상세 로그를 볼 수 있습니다. 최근 활동은 ~/Library/Logs/mole/operations.log의 작업 로그를 확인하세요. 명령이 아무 말 없이 실패하면 시스템 설정에서 전체 디스크 접근이 허용되었는지 확인하세요.
문제를 신고하려면 도움말 페이지의 문제 신고 섹션을 참조하세요.
