서론

유료 앱들의 핵심 기능을 단 하나의 바이너리로 통합한 강력한 오픈소스 CLI 도구, Mole을 소개. 특히 최근 유행하는 AI Agent와 연계하여 시스템 관리를 자동화하는 방법까지 함께 살펴보겠습니다.

1. Mole 유틸리티란?

Mole(tw93/Mole)은 tw93이 개발한 macOS용 올인원 시스템 유틸리티다. Go 언어와 셸 스크립트로 작성되어 매우 가볍고 빠르며, 터미널 환경에서 모든 시스템 최적화 작업을 통합 관리할 수 있다.

주요 특징

  • All-in-One: 청소, 앱 삭제, 최적화, 분석, 실시간 모니터링 기능을 단일 바이너리로 통합.
  • 오픈소스: MIT 라이선스 기반의 무료 도구로, 상업용 앱의 광고나 구독 모델 없이 모든 기능 제공.
  • 초경량: CLI 기반으로 동작하여 시스템 리소스 점유율이 매우 낮음.

2. 설치 방법

Homebrew를 통해 간단히 설치 가능하다.

# Homebrew 설치
brew install mole

또는 공식 설치 스크립트 이용:

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

3. 주요 명령어 및 운영 방법

Mole은 macOS 시스템 정리/분석/모니터링을 위해 5가지 핵심 명령어를 제공한다. 각 명령은 결과 요약과 권장 조치를 보여주고, 필요하다면 확인을 거쳐 다음 단계로 넘어간다. 아래에서 명령별 역할을 자세히 살펴보고 운영 루틴과 빠른 참조용 치트시트를 덧붙인다.

3.1 mole clean (시스템 청소)

  • 기능: 사용자/시스템 캐시, 로그, 임시 파일, 개발 도구(npm, Xcode, Docker) 관련 정크를 스캔하고 제거한다. 검사 후 삭제 가능한 항목을 분류해 요약을 보여주므로 무엇을 지우는지 파악하기 쉽다.
  • 운영 포인트: 정기적으로 실행해 누적된 로그와 캐시를 비우고, 렌더링이나 빌드 이후에 다시 돌아오는 디스크 용량 폭증을 방지한다. 수동 선택이 필요한 항목에는 별도 승인을 요구하므로 안전하다.

3.2 mole uninstall (스마트 앱 제거)

  • 기능: 선택한 앱의 본체와 환경설정/라이브러리/런치에이전트 등 주변 잔여물을 함께 제거한다. 이름으로 지정하면 관련된 파일을 그룹화하여 삭제 목록을 보여준다.
  • 운영 포인트: 베타 앱이나 문제가 있는 앱을 삭제할 때 사용하고, 삭제 전에는 연관 파일과 의존성을 미리 검토한다. Finder에서 결과를 확인하는 과정을 거쳐 실수로 중요한 파일을 지우지 않도록 설계되어 있다.

3.3 mole optimize (시스템 최적화)

  • 기능: LaunchServices 재설정, 시스템 서비스 새로고침, 캐시 재구축 등의 작업을 묶어서 실행하여 전체적인 반응 속도를 높인다.
  • 운영 포인트: 작업이 느려지거나 램/디스크 I/O가 높은 상황에서 mole status로 상태를 확인한 뒤 호출하면 빠르게 정상 상태로 전환된다. 반복 실행이 문제가 되는 드라이버나 에이전트는 별도로 유지 관리한다.

3.4 mole analyze (디스크 분석)

  • 기능: 전체 디스크 사용량, 대용량 파일 및 폴더를 확인할 수 있는 분석 결과를 제공한다. 시각화 없이 정보만 추출해 스크립트에 연결하기도 쉽다.
  • 운영 포인트: 월별 점검에서 주요 폴더를 조사하고 오래된 다운로드나 지원 파일을 정리하는 데 사용한다. 분석 결과를 기준으로 백업 또는 삭제 여부 결정을 내린다.

3.5 mole status (실시간 모니터링)

  • 기능: CPU, GPU, 메모리, 디스크, 네트워크 지표를 실시간으로 출력하며, 출력 결과를 로깅하거나 간단히 확인할 수 있는 대시보드 형태로 표시한다.
  • 운영 포인트: 장시간 빌드/테스트/렌더링 전에 상태를 기록하고, 문제가 발생하면 즉시 확인할 수 있도록 로그를 남겨둔다. 실시간 감시를 통해 mole optimize와 같은 후속 명령을 빠르게 결정할 수 있다.

3.6 운영 방법

  • 주기 세팅: mole clean을 주 1회, mole analyze를 월 1회 이상 돌려 기본 청소/분석 루틴을 유지한다. mole optimize는 상태에 이상이 있거나 팀에서 리포트한 성능 저하가 있을 때만 실행한다.
  • 워프 흐름: mole cleanmole statusmole optimize 순으로 묶으면 정리 → 확인 → 튜닝 흐름을 자동화파이프라인이나 Agent 워크플로에서 사용할 수 있다.
  • 로그 및 증빙: 실행 결과를 별도 로그 파일로 남기거나, mole status 로그를 빌드/배포 파이프라인의 상태 확인 단계에 포함하여 문제가 반복될 경우 루트 원인을 빠르게 추적한다.
  • Agent/스크립트 연동: mole-manager 스킬처럼, 감지된 이슈에 따라 명령어를 자연어로 호출하는 스킬을 만들고, 반복되는 체크리스트(예: 시스템 느림 → mole optimize)를 캘리브레이션한다.

3.7 Cheat Sheet

명령어설명자주 참조하는 상황
mole clean캐시·로그·임시 파일 정리디스크 여유 공간 부족, 빌드 후청소 결과를 보고 삭제 항목을 개별 확인
mole uninstall <앱>앱과 관련 잔여물 제거베타 앱 교체, 디스크 클리어삭제 전 결과를 미리 살피고 의존 관계 점검
mole optimize서비스/캐시 재설정 · 반응 속도 개선시스템 반응 속도 저하, 에이전트 경고mole status 결과와 함께 실행
mole analyze대용량 파일/폴더 분석월간 점검, 백업 전 정리결과를 기록해 두고 반복 정리 포인트로 삼기
mole statusCPU/GPU/메모리/디스크/네트워크 실시간 모니터링긴 빌드·배포 작업 전후로그 저장 또는 Agent 알림 트리거 용도로 활용

Cheat sheet를 바탕으로 쉘 함수나 Agent 스킬로 감시-정리-튜닝 루틴을 만들어 두면 손쉬운 운영이 가능하다.

4. Agent Skills와 함께 사용하기

이전 포스팅에서 다룬 Agent Skills와 연계하면 Mole의 활용도를 극대화할 수 있다. Antigravity나 Gemini CLI 환경에 전용 스킬을 정의하여 시스템 관리를 자동화한다.

Mole 전용 스킬 예시 (mole-manager.md)

~/.agent/skills/skills/mole-manager.md 에 아래 내용을 정의.

# Mole System Manager Skill
Mole 유틸리티를 사용하여 macOS 시스템을 진단하고 최적화한다.

## 지침
1. 사용자가 "청소해줘"라고 하면 `mole clean` 실행.
2. 시스템 지연 발생 시 `mole status` 분석 후 `mole optimize` 권장.
3. 앱 삭제 요청 시 `mole uninstall [앱 이름]` 사용.
4. 주기적 `mole analyze`로 대용량 파일 식별.

스킬 등록 후, "@mole-manager 시스템 상태 확인하고 필요한 조치 해줘" 와 같은 자연어 명령으로 자동화된 관리가 가능해진다.

5. 도입 효과

  1. 비용 절감: 다수의 유료 최적화 앱을 하나의 오픈소스 도구로 대체.
  2. 개발 환경 최적화: 개발 도구(npm, docker, xcode) 전용 청소 기능으로 쾌적한 환경 유지.
  3. 자동화: CLI 기반이므로 셸 스크립트나 AI Agent와 즉시 연동 가능.

관련 링크: