# guhcostan/mac-cleaner-cli

Free macOS CLI to clean disk space — caches, logs, Homebrew, Xcode. Open-source alternative to CleanMyMac

Repository: https://github.com/guhcostan/mac-cleaner-cli
Canonical: https://ross.abutalabs.com/products/mac-cleaner-cli
Homepage: https://www.npmjs.com/package/mac-cleaner-cli
Language: TypeScript
License: MIT
License Family: permissive
Topics: cleanup, cli, disk-space, macos, open-source, typescript, cache-cleaner, homebrew, nodejs, xcode, cache, developer-tools, disk-cleaner, free-disk-space, junk-cleaner, log-cleaner, mac, mac-utilities, macos-cleaner, system-cleanup
Last push: 2026-08-17T21:50:17+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 87, longevity 19
- inputs: {"age_days": 272, "days_push": 16, "days_rel": 85, "gap_med": 0.0, "n_releases_24m": 17}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1951, forks 179 (observed 2026-08-28T04:05:58.234244+00:00)

## What it is
A free, open-source macOS CLI tool that frees up disk space by scanning for and removing caches, logs, Homebrew leftovers, Xcode DerivedData, and junk files. It runs interactively via npx, letting users select exactly what to clean, with no subscriptions or telemetry.

## Use cases
- free up disk space on my mac from the terminal
- clean xcode derived data and caches
- remove homebrew download cache
- open-source alternative to CleanMyMac
- uninstall mac apps completely with leftover files
- flush dns cache and free purgeable space
- clean browser caches and logs on macOS

## When to choose
- you want a free, open-source disk cleaner without subscriptions or telemetry
- you prefer terminal-based tools and CI/CD-friendly automation
- you're a developer needing to clear Xcode, Homebrew, and dev caches regularly

## When to avoid
- you need a GUI disk space visualizer like DaisyDisk
- you're on Linux or Windows (use the companion windows-cleaner-cli instead)
- you need deep system optimization beyond junk file cleanup

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, developer-tools, file-system
- domain: developer-tools, operating-systems, self-hosted
- platform: cli
- tags: disk-cleanup, cache-cleaner, homebrew, xcode, junk-files, system-maintenance, app-uninstaller, open-source, command-line, macos, nodejs

## Member repositories
- guhcostan/mac-cleaner-cli (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:58.234244+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:06:49.240887+00:00, confidence not recorded.
  - readme: https://github.com/guhcostan/mac-cleaner-cli (fetched 2026-08-28T04:05:58.234244+00:00, sha 6ff3b968c440)
  - homepage: https://www.npmjs.com/package/mac-cleaner-cli (fetched 2026-08-29T10:46:39.705716+00:00, sha 8790f5537b27)
  - registry_npm: https://registry.npmjs.org/mac-cleaner-cli (fetched 2026-08-29T10:46:39.715253+00:00, sha 225fde935329)
- Data as of 2026-08-30T08:39:29.467469+00:00.