Skip to content

srmdn/orbital

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

orbital

macOS disk cleanup tool for developers. Knows what caches are safe, what's not, and what's silently eating your disk.

Why

General disk cleaners show you a treemap but can't tell the difference between:

  • ~/.npm (4 GB, safe to delete) vs ~/.ssh (never touch)
  • Chrome cache vs Chrome profile data (bookmarks, passwords)
  • A Claude sandbox VM vs your actual project files

Orbital knows. It was built from a real audit of a developer MacBook and understands every stack.

Commands

orbital scan      # Full audit — finds everything reclaimable
orbital size      # Quick disk space check
orbital hogs      # Top 20 space consumers in ~
orbital git-trap  # Check for accidental .git in home
orbital clean     # Interactive cleanup (coming soon)
orbital serve     # Web dashboard (coming soon)

Install

# Build from source
git clone https://github.com/srmdn/orbital.git
cd orbital
go build -o /usr/local/bin/orbital ./cmd/orbital

# Homebrew (coming soon)
brew install srmdn/tap/orbital

Cleanup Tiers

Tier Description Examples
1 — Safe Auto-regenerates npm, bun, pip, go, Homebrew caches
2 — Reinstall Manual recovery nvm, rustup, Android SDK
3 — App cleanup Clear in-app Chrome, Telegram, Docker
4 — Manual review Your files Downloads, DMGs, old projects
∞ — Never Permanent data .ssh, .gitconfig, Keychains, iCloud

Stack

Layer Tech
Engine Go stdlib only — single binary, no deps
Dashboard Astro (planned)
Dist Homebrew tap

Reference

Full cleanup guide — every cache, what it is, and how to handle it.

License

MIT

About

macOS disk cleanup tool for developers. Knows what caches are safe, detects the .git trap, and audits every stack.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors