macOS · Windows

Mole

Mac 심층 정리, 앱 제거, 시스템 최적화, 디스크 분석 및 상태 모니터링. 무료 오픈소스 CLI와 네이티브 Mac 앱.

English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français · Українська · Русский

💡 이 저장소는 무료 오픈소스 CLI(mo)입니다. 네이티브 앱을 원한다면 Mole for Mac을 별도로 내려받을 수 있습니다. 삭제 전 항목별 확인, 800개 이상 앱에서 테스트한 잔여 파일 정리, 유지보수, 디스크 단계별 분석, 실시간 상태 확인, 지원되는 Mac에서의 팬 제어를 제공합니다. Windows용 네이티브 앱은 Mole for Windows입니다. brew install mole은 CLI만 설치합니다.

• 올인원 CLI 툴킷: CleanMyMac, AppCleaner, DaisyDisk, iStat Menus 스타일의 워크플로를 하나의 터미널 명령으로 통합
• 심층 정리: 캐시, 로그, 잔여물 및 삭제된 앱이 남긴 데이터를 제거하여 디스크 공간 확보
• 스마트 앱 제거: 앱과 함께 연결된 LaunchAgents, 환경설정, 잔여 파일을 정리
• 디스크 분석기: 인터랙티브 TUI로 디스크 사용량을 시각화하고 대용량 파일 탐색
• 시스템 최적화: DNS 플러시, QuickLook 및 아이콘 캐시 재구축, 핵심 시스템 데이터베이스 최적화
• 실시간 모니터링: CPU, 메모리, 디스크 I/O, 네트워크 트래픽 및 프로세스 상태를 실시간 확인

Mole은 macOS 12 이상을 지원하며, Intel 및 Apple Silicon Mac 모두에서 동작합니다. 현재 macOS 버전에서 Homebrew 설치가 어려우면 설치 스크립트를 사용하세요.

Homebrew로 설치

brew install mole

설치 스크립트로 설치

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash

AI 에이전트로 설치

에이전트에게 이렇게 말하면 됩니다:

Install Mole for me by reading https://raw.githubusercontent.com/tw93/Mole/main/llms.txt

스킬을 직접 설치할 수도 있습니다. 설치하면 Claude Code, Codex, Cursor 등 에이전트가 무엇이든 삭제하기 전에 --dry-run으로 목록을 먼저 보여 주고, 앱 제거와 관리자 권한이 필요한 단계는 직접 실행하도록 남겨 둡니다. 업데이트는 npx skills update -g -y로 합니다.

npx skills add tw93/Mole -a claude-code codex cursor -g -y

호스트 플러그인으로 설치하려면 Claude Code에서 /plugin marketplace add tw93/Mole 다음 /plugin install mole@mole, Codex에서 codex plugin marketplace add tw93/Mole 다음 codex plugin add mole@mole을 실행합니다.

주요 명령어

mo                           # 대화형 메뉴 열기
mo clean                     # 심층 정리: 시스템 캐시, 로그 및 삭제된 앱 잔여 파일 정리
mo uninstall                 # 앱 제거: 설치된 소프트웨어와 관련 설정 파일 완전 삭제
mo optimize                  # 시스템 최적화: 시스템 서비스와 캐시 새로고침
mo analyze                   # 디스크 분석: 인터랙티브 디스크 용량 분석 및 대용량 파일 탐색
mo status                    # 상태 모니터링: CPU, 메모리, 네트워크 및 하드웨어 실시간 대시보드
mo purge                     # 프로젝트 정리: 개발 빌드 결과물(node_modules, target 등) 정리
mo installer                 # 설치 파일 정리: 설치 파일 탐색 및 삭제
mo slim                      # 앱 슬림화: 유니버설 앱의 Intel용 코드 제거

mo touchid                   # 터미널 sudo용 Touch ID 지문 인증 설정
mo completion                # 셸 Tab 키 자동완성 구성
mo update                    # Mole 업데이트 확인 및 실행
mo update --nightly          # 최신 미출시 개발 빌드로 업데이트(스크립트 설치 환경 전용)
mo remove                    # 시스템에서 Mole 완전 삭제
mo --help                    # 도움말 표시
mo --version                 # 설치된 버전 확인

안전 미리보기 (Dry Run)

mo clean --dry-run
mo uninstall --dry-run
mo optimize --dry-run
mo purge --dry-run
mo installer --dry-run
mo slim --dry-run
mo history
mo history --json

mo clean --dry-run --debug   # 안전 미리보기 + 상세 진단 로그
mo optimize --whitelist      # 보호할 최적화 규칙 관리
mo clean --whitelist         # 보호할 캐시 화이트리스트 관리
mo purge --paths             # 프로젝트 검사 디렉터리 구성
mo analyze /Volumes          # 외장 드라이브만 분석
mo analyze /private/tmp      # 임시 디렉터리 검토(자동 삭제 없음)

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s -- 1.51.0
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s -- main

mkdir -p "$HOME/.local/bin"
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s -- --prefix "$HOME/.local/bin"
export PATH="$HOME/.local/bin:$PATH"

nix profile install github:tw93/mole/main#mole
nix profile upgrade mole
nix profile remove mole

Windows에서 설치 (Windows CLI)

iwr -useb https://raw.githubusercontent.com/tw93/Mole/windows/quick-install.ps1 | iex

Mole은 Homebrew, 이 저장소, mole.fit에서만 배포됩니다. molemac.com, moleapp.net, molefit.com은 Mole이 아니며, mole.bluecatbot.com의 Windows 앱은 이름이 같은 별도의 커뮤니티 프로젝트입니다.

Mole은 파일을 삭제할 수 있으므로 경로를 검증하고, 공유 위치와 시스템 소유 위치를 보호하며, 필요할 때 확인을 요청합니다. 안전하게 변경할 수 있다고 확인할 수 없는 항목은 건너뛰거나 거부합니다.

• clean, uninstall, purge, installer, slim, remove 명령은 파일을 삭제하므로 먼저 --dry-run으로 확인하고 필요 시 --debug를 함께 사용하세요
• 일상적인 Mole 실행에는 sudo가 필요하지 않으며, 시스템 수준의 정리 작업에만 관리자 권한을 요청합니다
• mo uninstall, mo analyze, mo slim은 확인 후 삭제 항목을 기본적으로 휴지통으로 이동합니다. clean, purge, installer는 영구 삭제하며, mo uninstall --permanent는 휴지통을 거치지 않습니다
• 정리 내역은 ~/Library/Logs/mole/operations.log에 기록되며, mo history로 확인하거나 MO_NO_OPLOG=1로 비활성화할 수 있습니다
• mo clean --whitelist로 보존할 캐시를 지정하거나 mo optimize --whitelist로 제외할 유지보수 작업을 관리하세요
• 화이트리스트 파일을 읽을 수 없으면 clean, purge, optimize는 이를 무시하고 실행하지 않고 중단합니다

취약점 신고 방법, 안전 경계, 현재 한계는 SECURITY.md 및 SECURITY_AUDIT.md를 참고하세요.

아래 예시는 축약된 화면입니다. 실제 표시 항목, 용량, 건너뛴 이유는 사용 중인 Mac 환경에 따라 다릅니다.

mo clean은 안전한 캐시, 로그, 임시 파일, 개발 도구 캐시 및 이미 삭제된 앱의 잔여 파일을 검사하고 정리하며, 기본적으로 ~/.Trash를 비웁니다. 휴지통을 유지하려면 mo clean --whitelist에서 Trash를 선택하세요. 같은 메뉴에서 보존할 캐시도 지정할 수 있고, /Volumes/*/.Trashes 같은 볼륨 휴지통은 함께 비워지지 않습니다. 선택한 항목은 ~/.config/mole/whitelist에 저장됩니다. 직접 경로를 추가하려면 먼저 메뉴를 열고 Enter를 눌러 선택 항목을 저장한 뒤, 한 줄에 하나씩 경로를 추가하세요. 이 파일이 있으면 선택적 기본 규칙을 대체하며, 내장 안전 보호는 계속 적용됩니다.

$ mo clean

Clean Your Mac

⚙ Apple Silicon | Free space: 219.0GB

➤ User essentials
  ✓ User app cache · 18 items, 2.4GB
  ✓ User app logs · 7 items, 12.8MB
  ✓ Trash · emptied, 9 items

➤ App caches
  ✓ App Store cache · 8 items, 248.5MB

➤ Browsers
  ✓ Safari cache · 24 items, 642.1MB
  ✓ Chrome cache · 31 items, 1.2GB

➤ Developer tools
  ✓ npm cache · cleaned
  ◎ pnpm cache · skipped (pnpm busy)

======================================================================
Cleanup complete
Tracked cleanup: 4.5GB | Items cleaned: 97 | Categories: 4
Free space: 223.5GB (+4.5GB)
======================================================================

mo uninstall은 설치된 앱과 함께 Mole이 해당 앱의 것으로 확인할 수 있는 관련 파일을 제거합니다. 같은 앱의 다른 설치본이 아직 사용하는 공유 파일은 보존됩니다. 이미 삭제된 앱의 경우 mo clean을 실행하여 남은 잔여물을 찾으세요.

설정과 플러그인 등 개인 데이터는 기본적으로 보존됩니다. 삭제 미리보기에서 D를 누르면 삭제할 데이터 경로를 개별적으로 선택할 수 있습니다. mo uninstall --with-data를 사용하면 브라우저 프로필과 App Group 컨테이너를 제외한 이 데이터가 미리 선택되고 미리보기에서 따로 표시되며, D로 원하는 경로를 계속 보존할 수 있습니다. 삭제 후 shell, Hook, MCP 설정에 삭제된 경로의 참조가 있으면 파일과 줄 번호만 표시하며, 설정은 수정하지 않습니다.

$ mo uninstall

Select Apps to Remove  1/3 selected

➤ ● Photoshop 2024                4.20GB | 2mo ago
  ○ IntelliJ IDEA                 2.80GB | 3d ago
  ○ Premiere Pro                  3.40GB | 2w ago

Files to be removed:

✓ Photoshop 2024, 4.20GB
  ✓ /Applications/Adobe Photoshop 2024/Adobe Photoshop 2024.app

Personal data kept:
  ~/Library/Application Support/Adobe/Adobe Photoshop 2024
  ~/Library/Preferences/com.adobe.Photoshop.plist

D choose personal data

======================================================================
Uninstall complete
Removed 1 app, freed 4.20GB: Photoshop 2024
======================================================================

mo optimize는 지원되는 Finder, 네트워크, 데이터베이스, macOS 서비스에 대해 범위가 정해진 유지보수를 실행합니다. 불필요하거나, 지금 실행하기에 안전하지 않거나, 사용할 수 없는 작업은 이유와 함께 건너뜁니다. mo optimize --whitelist로 작업이나 경로 패턴을 제외할 수 있어, /Volumes/mail처럼 상시 마운트되는 디스크 이미지가 마운트 해제 후보로 표시되지 않게 할 수 있습니다.

$ mo optimize

Optimize

⚙ System  18/32 GB RAM | 616/926 GB Disk | Uptime 6d

PERFORMANCE DIAGNOSIS
  ✓ No sustained high-CPU bottleneck detected

➤ Finder Cache Refresh
  → QuickLook thumbnails refreshed
  → Icon services cache rebuilt

➤ Network Cache Refresh
  → DNS cache refreshed

➤ Database Optimization
  ◎ Close these apps before database optimization: Safari

➤ Disk Health
  → Disk verify skipped

======================================================================
Optimization Complete
Applied 2 optimizations
13 unchanged | 3 skipped | 1 unavailable
======================================================================

mo analyze는 터미널 기반의 인터랙티브 디스크 탐색기입니다. 방향키와 Vim 단축키 탐색, 빠른 필터링, 다중 선택, Finder 미리보기 및 휴지통 이동을 지원합니다. 외장 드라이브는 기본 뷰에서 제외되며 mo analyze /Volumes 또는 특정 마운트 경로로 확인할 수 있습니다. mo analyze /private/tmp를 사용하면 자동 삭제 없이 임시 파일만 확인할 수 있습니다. 파일별 스캔에서는 모든 블록을 공유하는 APFS 클론을 한 번만 계산합니다. 폴더 크기를 빠르게 추정할 때는 공유 블록이 중복 계산될 수 있습니다.

크기 뒤에 +가 붙은 항목은 부분 검사를 의미하며, unknown은 계산이 불가능했음을 나타냅니다. 일시적인 시간 초과로 중단된 결과는 기존 캐시를 덮어쓰지 않으므로 나중에 다시 검사하여 보완할 수 있습니다. macOS가 터미널의 읽기를 허용하지 않는 폴더는 접근 권한이 바뀔 때까지 부분 검사로 남습니다. 터미널에는 상위 30개 항목만 표시되므로 읽을 수 없는 항목이 목록 밖에 있을 수 있지만, 합계는 여전히 부분 검사로 표시됩니다. JSON 출력에는 모든 항목이 포함됩니다.

mo analyze --json /path 출력에는 결과 전체와 각 항목의 scan_status(complete, partial, unavailable)가 포함됩니다. 숫자 크기는 실제로 측정한 바이트이며, unavailable일 때의 0은 빈 디렉터리를 뜻하지 않습니다. 부분 검사도 종료 코드 0으로 끝나므로 스크립트에서는 scan_status를 확인해야 합니다. 완전성은 Mole의 기존 검사 제외 범위 안에서만 판단되며, 파일 시스템의 원자적 스냅샷을 보장하지 않습니다.

$ mo analyze

Analyze Disk  (302.1GB free)
Select a location to explore:

 ▶  1. ████████████████████████  47.9%  |  Home                       75.4GB
    2. ███████████               22.0%  |  User Library               34.6GB
    3. ███████                   14.2%  |  Applications               22.4GB
    4. █████                     10.7%  |  System Library             16.9GB
    5. ███                        5.2%  |  Old Downloads (90d+)       8.2GB  >3mo

mo status는 하드웨어, 시스템 부하, 디스크 읽기/쓰기, 네트워크 트래픽, 전원 및 프로세스를 한눈에 보여주는 읽기 전용 대시보드입니다.

기본 IPv4 라우팅이 VPN이나 터널 인터페이스를 사용하는 경우 물리 어댑터와의 중복 집계를 방지하기 위해 해당 인터페이스를 추적합니다. JSON 출력에는 라우팅된 터널을 포함해 인터페이스별 속도가 남고, 기본 경로가 아닌 유휴 터널은 숨겨집니다.

$ mo status

Mole Status  Health ● 92  MacBook Pro · M4 Pro · 32GB · macOS 26

⚙ CPU                                    ▦ Memory
Total   ████████████░░░░░░░  45.2%       Used    ███████████░░░░░░░  58.4%
Load    0.82 / 1.05 / 1.23 (8 cores)     Total   18.7 / 32.0 GB
Core 1  ███████████████░░░░  78.3%       Free    ████████░░░░░░░░░░  41.6%
Core 2  ████████████░░░░░░░  62.1%       Avail   13.3 GB

▤ Disk                                   ⚡ Power
Used    █████████████░░░░░░  67.2%       Level   ██████████████████  100%
Free    156.3 GB                         Status  Charged
Read    ▮▯▯▯▯  2.1 MB/s                  Health  Normal · 423 cycles
Write   ▮▮▮▯▯  18.3 MB/s                 Temp    58°C · 1200 RPM

⇅ Network                                ▶ Processes
Down    ▁▁█▂▁▁▁▁▁▁▁▁▇▆▅▂  0.54 MB/s      Zombies 3 · Chrome (4242) ×3
Up      ▄▄▄▃▃▃▄▆▆▇█▁▁▁▁▁  0.02 MB/s      Code       ▮▮▮▮▯  42.1%
Proxy   HTTP · 192.168.1.100             Chrome     ▮▮▮▯▯  28.3%

건강 점수는 CPU, 메모리, 여유 공간, SMART 상태, 입출력, 온도, 배터리 상태, 가동 시간을 종합하여 산출합니다. k 키로 고양이 표시 전환, c 키로 표시 코어 수 조절, q 키로 종료할 수 있으며, 설정은 자동 저장됩니다.

$ mo analyze --json ~/Documents
{
  "path": "/Users/you/Documents",
  "overview": false,
  "entries": [
    { "name": "Library", "path": "...", "size": 80939438080, "is_dir": true }
  ],
  "large_files": [
    { "name": "backup.zip", "path": "...", "size": 8796093022 }
  ],
  "total_size": 168393441280,
  "total_files": 42187
}

$ mo status --json
{
  "host": "MacBook-Pro",
  "health_score": 92,
  "cpu": { "usage": 45.2, "logical_cpu": 8 },
  "memory": { "total": 34359738368, "used": 20078972109, "used_percent": 58.4 },
  "disks": [],
  "process_collected_at": "2026-08-29T12:30:00Z",
  "process_stale": false,
  "zombie_count": 3,
  "zombie_parents": [
    { "pid": 4242, "name": "Google Chrome for Testing", "count": 3 }
  ],
  "zombie_parents_complete": true,
  "uptime": "3d 12h 45m"
}

mo purge는 언제든 다시 빌드할 수 있는 프로젝트 산출물(node_modules, target, .build, build, dist 등)을 탐색합니다. 프로젝트별로 묶어 보여주며, 체크하여 승인한 항목만 휴지통을 거치지 않고 영구 삭제합니다. 최근 7일 내 변경되었거나 변경 시점을 확인할 수 없는 항목은 기본적으로 체크 해제됩니다. fd를 우선 사용하고 없을 경우 find로 대체하며, 배포 키 파일, 중첩된 Git 저장소, Git 추적 파일이 포함된 디렉터리는 자동으로 보호됩니다. 비대화형 모드는 mo purge --yes가 필요하고, mo purge --dry-run으로 후보를 먼저 확인할 수 있습니다.

Page Up/Down 또는 h/l로 페이지 이동, [/]로 프로젝트 간 이동, X로 해당 프로젝트를 건너뛰고 다음으로 이동합니다. /로 프로젝트 경로와 산출물 이름을 검색하고, n으로 선택 상태를 바꾸지 않고 다음 일치 항목을 찾으며, Enter 키는 최종 경로 확인 화면을 엽니다. 표시되는 용량은 추정치이며, 측정하지 못한 산출물과 불완전한 검사는 따로 표시됩니다.

$ mo purge

Purge Project Artifacts

Select Artifacts to Purge
6.00GB, 2 selected

➤ ● ┌ ~/Projects/website        3.80GB | node_modules | 28d
  ○ └ ~/Projects/website         186MB | dist         | <1d
  ● ┌ ~/Projects/rust-app       2.20GB | target       | 2mo
  ○ └ ~/Projects/rust-app         22MB | dist         | <7d

======================================================================
Purge complete
Estimated space freed: 6.00GB | Items: 2 | Free: 223.5GB
======================================================================

~/Documents/MyProjects
~/Work/ClientA
~/Work/ClientB

mo installer는 다운로드, 데스크탑, Homebrew 캐시, iCloud, Mail, Telegram 등 자주 쓰이는 디렉터리에서 DMG, PKG, MPKG, ISO, XIP 및 설치용 ZIP 파일을 찾습니다. 삭제 전 각 파일의 용량과 위치가 표시됩니다. 검사에는 전체 제한 시간이 적용되며, 검사나 메타데이터 확인이 실패하거나 시간 초과되면 목록을 버리고 파일을 선택하지 않습니다. 손상되었거나 읽을 수 없는 ZIP 압축 파일은 건너뛰고, 심볼릭 링크로 된 검사 루트는 지원하지만 그 아래의 심볼릭 링크는 따라가지 않습니다. 최종 삭제 직전에는 파일 변경 여부를 한 번 더 확인합니다.

$ mo installer

Select Installers to Remove, 3.83GB, 5 selected

➤ ● Photoshop_2024.dmg          1.20GB | Downloads
  ● IntelliJ_IDEA.dmg          850.6MB | Downloads
  ● Illustrator_Setup.pkg      920.4MB | Downloads
  ● PyCharm_Pro.dmg            640.5MB | Homebrew
  ● Acrobat_Reader.dmg         220.4MB | Downloads
  ○ AppCode_Legacy.zip         410.6MB | Downloads

======================================================================
Installers cleaned
Removed 5 installers, freed 3.83GB
======================================================================

mo slim은 Apple Silicon Mac에서 유니버설 앱에 포함된 Intel용 코드를 제거합니다. 본인 소유이면서 Developer ID로 서명된 앱과 각 앱의 Intel용 코드 용량을 보여 주고, 선택한 앱만 처리합니다. 각 앱은 먼저 복사본에서 정리되며, 메인 실행 파일과 자체 서명을 가진 중첩 코드만 대상으로 합니다. 복사본이 Apple Silicon용 코드를 유지하고 코드 서명과 Gatekeeper 검사를 통과해야만 원래 앱을 대체하며, 원래 앱은 휴지통으로 이동합니다. App Store 앱, Apple 앱, Rosetta를 사용하여 열도록 설정된 앱, 다른 사용자가 소유한 앱, 실행 중인 앱은 처리하지 않습니다. 개발 도구는 필요 없으며, 앱을 업데이트하면 Intel용 코드가 다시 생깁니다.

curl -fsSL https://raw.githubusercontent.com/tw93/Mole/main/scripts/setup-quick-launchers.sh | bash

Mole 제작에 힘을 보태주신 모든 기여자분들께 감사드립니다. 이분들을 팔로우해 보세요 ❤️

X (Twitter)에 공유해 주신 사용자들의 생생한 후기:

영상 설명이 편하신가요? PAPAYA 電腦教室에서 제작한 Mole 튜토리얼 영상을 확인해 보세요.

• Mole for Mac을 구매하시는 것이 Mole 개발을 지속하는 가장 직접적인 힘이 됩니다
• Mole이 마음에 드셨다면 GitHub Star를 눌러주시고, 주변에 공유해 주시거나 Issue/PR로 함께해 주세요
• 제게는 '탕위안'과 '콜라'라는 고양이 두 마리가 있는데, Mole이 유용하셨다면 두 아이에게 맛있는 캔 🥩 하나 선물해 주세요

이미 고양이들에게 간식을 선물해 주신 분들 🐱

Mole은 GPL-3.0 라이선스 하에 오픈소스로 공개되어 있습니다. 자세한 내용은 LICENSE를 참조하세요. 코드를 수정하여 배포하는 경우 동일한 라이선스를 유지해야 합니다. 프로젝트를 포크하는 경우 고유한 이름을 사용하고 Mole을 원출처로 명시해 주세요. Mole for Mac은 별도의 비공개 소스 앱입니다. Mole은 앞으로도 계속 유지보수됩니다.