Repository navigation
Mothball 0.1.0
Mothball puts idle projects away to get your disk back.
It finds build output you can regenerate (node_modules, target, .venv, build, Pods, DerivedData and more across 22 stacks) in projects you have not touched in a while, and moves it to the Trash. Coming back to a project? mothball wake reinstalls what it needs.
Install
macOS app (Apple silicon and Intel, macOS 11+)
Download Mothball-0.1.0.dmg, open it and drag Mothball to Applications. It is signed and notarised.
Or with Homebrew:
brew tap herocodess/tap
brew trust herocodess/tap
brew install --cask mothball
Command line only
go install github.com/herocodess/mothball/cli/mothball@v0.1.0
or download the binary for your system below.
What's in 0.1.0
- Menu bar app with a background service and Autopilot: keeps free space above a target you set, clearing the longest idle projects first
- 22 rule packs: JavaScript and TypeScript, Angular, Rust, Python, Gradle (Java, Kotlin, Android), Maven, sbt, Swift Package Manager, CocoaPods, Flutter, .NET, Ruby, PHP, Elixir, Erlang, Haskell, Zig, CMake, Unity, Unreal, Godot and Terraform
- Tool caches: Xcode, simulators, npm, pnpm, yarn, bun, pip, uv, CocoaPods, Homebrew, Gradle and others, cleaned with each tool's own command where it has one
- Safe by design: never touches git tracked files, never matches by folder name alone, skips projects with uncommitted work, re-checks every folder right before moving it, and only ever moves to the Trash
.mothballignoreto keep anything you choose
Notes
- macOS is the main target for this release. The Windows and Linux command line builds pass the full test suite but are early; the desktop app for them comes next.
- Mothball asks for Full Disk Access so it can see projects in Desktop, Documents and Downloads. Without it, those folders are skipped.
Checksums are in checksums-0.1.0.txt.