Skip to content
Projects

carloshpdoc/Harbofly has 27 GitHub stars and 1 forks. Star changes are not measured yet. Last checked 2026-11-18 05:28 UTC. Last push 2026-11-14.

How these counts are measured

What you can do

  • Per-project DerivedData: each Xcode project's build folder shows up on its own, resolved to the workspace that owns it.
  • App uninstaller with last-used dates: lists installed apps with their full footprint (bundle + every leftover it scatters), and when each app was last opened — so the ones you haven't touched in months float up. Sort by size, last used, vendor or category, search by name, and uninstall (to the Trash, restorable).
  • Startup items manager: see what launches on its own at login and in the background (Docker, updaters, agents…) and disable the excess — reversible (the agent is moved aside, not deleted; re-enable anytime). System/root daemons are shown read-only.
  • Age on every item: each cache/artifact shows how long since it was last touched, so you know at a glance what's abandoned.

Measured star growth

in 24h
Update delayed
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Menu bar app that finds and frees the disk space dev build artifacts and caches hog on macOS. Free, open source, notarized, zero telemetry.

Developer Tools

README.md

Original

Harbofly

Featured on Awesome Mac

🇧🇷 Português · 🇺🇸 English

The disk cleaner built for developers. Recover 20-100 GB from node_modules, Docker, Gradle, Xcode and build caches, safely. → harbofly.app

A macOS menu-bar app that finds on its own what's eating your disk and lets you clean it in one click, with zero path configuration.

It was born from a real pain: an iOS/Android dev Mac piles up tens of GB of build artifacts and caches (build/, .build/, node_modules/, DerivedData, SPM/Homebrew/Yarn/pip caches…) that nobody remembers to clean. Harbofly scans those places automatically, shows how much you can recover, and groups everything by risk level, and, by default, sends it all to the Trash (so you can restore it).

Free · Open source · Apple-notarized · Privacy-first (opt-in, anonymous analytics).

Harbofly selecting all safe items and freeing 85 GB in one click

▶ Full demo at harbofly.app

Idle project detection: project idle for 5 months, with a warning about uncommitted or unpushed changes

It knows which projects you abandoned — and warns you if they still hold unpushed work.

Featured

Listed on Awesome Mac, the curated directory of standout macOS apps, and shared by its maintainer @jaywcjlove. It's described there as "a menu bar app that auto-discovers and frees the disk space dev build artifacts and caches hog."

Install

brew install --cask carloshpdoc/tap/harbofly

Or download the notarized .dmg at harbofly.app.

CLI

The app binary doubles as a CLI — the Homebrew install exposes it as harbofly:

harbofly scan                # list caches/artifacts with size and risk tier
harbofly scan --json         # machine-readable output
harbofly clean --dry-run     # preview what a safe clean would move to the Trash
harbofly clean               # move every 🟢 safe item to the Trash
harbofly clean --stale-only  # only artifacts from projects idle for 90+ days

harbofly volumes             # every disk plugged in, with size, free space and flags
harbofly index /Volumes/T7   # what's on it: coverage, space, by folder/extension/size
harbofly compare /Volumes/T7 # what already exists on another disk, what repeats
                             #   inside it, what only exists there
harbofly compare /Volumes/T7 --subtrees   # folders duplicated in full
harbofly compare /Volumes/T7 --apply      # remove only what was proven to exist elsewhere

The CLI only ever touches the 🟢 safe tier and always goes through the Trash. compare refuses read-only, network and Time Machine volumes, and tells you when a disk has no Trash (deleting there cannot be undone). Installed from the DMG? Run /Applications/Harbofly.app/Contents/MacOS/Harbofly scan.

Use it with your AI agent

Harbofly ships an agent skill so Claude Code, Codex, or any AGENTS-aware tool can scan and safely clean your disk for you — handy for a nightly cleanup task. See skills/harbofly-cleanup/: it wraps the CLI above, with SKILL.md (Claude Code), AGENTS.md (Codex), and a README covering install per agent.

Features

  • Auto-discovery: scans ~/Development for build artifacts across 20+ stacks — node_modules, .build, target (Rust/Maven/SBT), .gradle, .dart_tool, vendor (Go/PHP), bin/obj (.NET), _build (Elixir), .terraform, .godot, zig-out and more (generic names are guarded by the ecosystem's marker file, so your own folders are never touched), plus 25+ known cache locations — package managers (npm, pnpm, Bun, Gradle, Maven, Cargo, Go, Flutter, pip, uv, CocoaPods, Homebrew…), editors (VS Code, Cursor, JetBrains) and AI tools (Ollama, Hugging Face, LM Studio model weights). Zero path config.
  • Every disk you plug in: a resizable Disks window lists each mounted volume — external drive, USB stick, card — with its own free space, and reads it to show where the bulk is, by folder, by extension and by size. Then it compares one disk against the others and splits the result in three: what already exists on another disk (proven byte for byte, so freeing it here loses nothing), what repeats inside that same disk, and what only exists there — the part a migration has to carry, not delete. Folders duplicated in full collapse into a single line, because on a backup disk the duplicate is the tree, not the file. Every count closes: files read + skipped + failed = files visited, with the reason for each, so "nothing found" can never be a silent bug.
  • Per-project DerivedData: each Xcode project's build folder shows up on its own, resolved to the workspace that owns it.
  • Stale project detection: projects with no activity for 90+ days get a badge — and a red warning if they hold uncommitted or unpushed work (read from your local git, fully offline).
  • Auto-clean (opt-in, free): let Harbofly do the chore itself — at the end of the day, at the start of the day, when Xcode quits, weekly, or when disk runs low. You pick the scope (tool caches → idle projects → everything 🟢) and the minimum. Only 🟢 safe items, always through the Trash, with a notification and history. After a few manual cleanups it offers to take over in one tap. The automation other cleaners lock behind a paid Pro plan — here it's free.
  • Simulators, one or many: delete unavailable simulators in one click, or expand CoreSimulator into a per-simulator list — each with its size — and remove only the ones you select (simctl delete, two-step confirm). It also lists the simulator runtimes (the iOS images, which live outside that folder and can hold more than the simulators themselves) with size, how many simulators depend on each and when it was last used, so a never-used runtime is easy to spot and delete. It also clears XCTestDevices, the throwaway sim clones that parallel-test / xcodebuildmcp runs pile up.
  • App uninstaller with last-used dates: lists installed apps with their full footprint (bundle + every leftover it scatters), and when each app was last opened — so the ones you haven't touched in months float up. Sort by size, last used, vendor or category, search by name, and uninstall (to the Trash, restorable).
  • Startup items manager: see what launches on its own at login and in the background (Docker, updaters, agents…) and disable the excess — reversible (the agent is moved aside, not deleted; re-enable anytime). System/root daemons are shown read-only.
  • Age on every item: each cache/artifact shows how long since it was last touched, so you know at a glance what's abandoned.
  • Git worktrees, including the ones AI agents leave behind: every worktree linked to a repo under ~/Development (Claude Code's .claude/worktrees included), each a full checkout that quietly takes GBs. The clean ones can be removed with git worktree remove (never forced; the branch stays in the repo, and you get the commands to bring them back); locked ones and ones with pending files are shown with the reason. Optional weekly reminder for idle worktrees, and opt-in automatic removal inside auto-clean.
  • Search and sort in the cleaner and apps lists; the cleaner's sections can be collapsed and reordered by dragging.
  • macOS purgeable space, explained: shows how much space Time Machine snapshots and system caches hold — the classic "I deleted 20 GB and Finder shows nothing".
  • 7 languages: Português, English, Español, Français, Deutsch, 中文, 한국어 — switching instantly.
  • In-app feedback: a bug or idea goes straight to the maintainer, no account needed.
  • Disk bar at the top, colored by pressure: green → orange (<20%) → red (<10%).
  • "Recoverable: X GB": the total you can free right now.
  • Risk tiers:
    • 🟢 Safe: regenerates itself on the next build.
    • 🟡 Caution: rebuilds, but it costs (recompiling from scratch, re-downloading device symbols).
    • 🔵 Informative: large folders it shows just so you know where the space is, but never deletes (CoreSimulator, Application Support, Downloads).
  • Trash-first by default: restorable. Permanent delete exists, but it's opt-in and you confirm first.
  • Each item shows its name, full path, and what it is.
  • "Select safe" checks the whole safe tier at once.
  • Low-space notification: warns you when free space drops below the threshold you pick (5/10/15/20%).
  • Automatic rescan every 30 min + a manual button.
  • Auto-update via Sparkle: notifies you when a new version ships (can be turned off).

Safety

Since it's a tool that deletes files, it's built to be trustworthy:

  • Default = Trash (restorable); nothing risky is pre-selected; confirmation before any deletion.
  • Open source end to end: you can audit exactly what leaves your machine. Analytics is opt-in and off by default; when on, it sends only anonymous, aggregate usage stats (events, GB recovered, cache categories, plus non-identifying device info: Mac model, macOS version, language, country and theme) — never your email, IP, name, paths, or project names. Toggle it anytime in preferences.
  • Signed with a Developer ID + notarized by Apple; build provenance (SLSA) on every release, verifiable with gh attestation verify Harbofly.dmg --repo carloshpdoc/Harbofly.

What it scans

~/Development (auto-discovery, up to depth 3): build, .build, node_modules, Pods, DerivedData, all classified 🟢 Safe.

~/Library (known targets):

Path Tier What it is
Developer/Xcode/DerivedData 🟢 Xcode build intermediates
Developer/XcodeBuildMCP/workspaces 🟢 XcodeBuildMCP workspaces
Caches/org.swift.swiftpm 🟢 Swift Package Manager cache
Caches/Homebrew 🟢 Homebrew downloads
Caches/Yarn 🟢 Yarn cache
Caches/pip 🟢 pip cache
Developer/Xcode/iOS DeviceSupport 🟡 Device symbols (recreated when you plug in an iPhone)
Caches/ms-playwright 🟡 Browsers downloaded by Playwright
Caches/Google 🟡 Google/Chrome cache

Informative (read-only, never deleted): Library/Developer/CoreSimulator, Library/Application Support, Downloads.

Items under 10 MB are ignored to reduce noise. The targets live in scanDevelopment(), scanLibrary() and scanInfo() in Sources/Harbofly/App.swift, easy to tweak.

Requirements

  • macOS 14+ (Sonoma)
  • Apple Silicon
  • Swift 6 (Xcode toolchain)

Build & Run

# Builds signed Harbofly.app and prints where it landed
./make-app.sh

# Open it (the icon shows up in the menu bar)
open Harbofly.app

To distribute outside the Mac App Store (sign with Developer ID, notarize, staple and build the styled .dmg):

# needs SIGN_ID, ASC_KEY_ID and ASC_ISSUER_ID in the env + the .p8 in ~/.appstoreconnect/private_keys/
./make-dmg.sh   # produces a ready-to-distribute Harbofly.dmg

Official releases go out via GitHub Actions when you push a vX.Y.Z tag: build + notarization + build provenance + .dmg + Sparkle appcast + automatic cask bump in the tap.

During development:

xcrun swift build            # debug
xcrun swift run              # run directly (no .app; Sparkle stays inert)
xcrun swift build -c release # release

Versioning

  • User-facing SemVer in the VERSION file (single source of truth).
  • Monotonic build number = commit count (git rev-list --count HEAD).

Structure

Harbofly/
├── Package.swift                 # SwiftPM (macOS 14+) + Sparkle dependency
├── Sources/Harbofly/App.swift    # the whole app: scanner + UI (display name in AppInfo.name)
├── Assets/                       # icon art (HarboflyIcon.png) + Harbofly.icns
├── VERSION                       # user-facing SemVer
├── appcast.xml                   # Sparkle update feed (generated on release)
├── make-app.sh                   # builds Harbofly.app (embeds + signs Sparkle)
├── make-dmg.sh                   # signs (Developer ID) + notarizes + builds the .dmg
├── make-icon.sh                  # generates the .icns from the art
├── .github/workflows/release.yml # release CI (tag v* → build/notarize/appcast/cask)
├── SETUP-SPARKLE.md              # how to configure the auto-update keys
└── README.md

Auto-update (Sparkle)

The app checks a signed (EdDSA) appcast and offers the update. It stays inert until the keys are configured, see SETUP-SPARKLE.md. Homebrew users update with brew upgrade.