appcleaner

A simple macOS app uninstaller that makes cleanup fast.

Why this exists

Uninstalling apps from macOS Settings -> General -> Storage -> Applications can be a hassle.

This tool cuts that flow down to a few taps:

• scan installed apps
• pick what to remove
• discover related files
• uninstall with undo-friendly trash staging

What it does

• Interactive CLI app selection
• Deep file discovery for app traces
• Safe staging to local trash before removal
• Undo/restore support from trash entries
• Trash listing and cleanup actions

Requirements

• macOS
• Bun for development
• Node.js (v18+) for npm users

Install

For developers (clone this repo)

bun install

Global install (published package)

With npm:

npm install -g @m27oflegend/appcleaner

With bun:

bun add -g @m27oflegend/appcleaner

Then run:

appcleaner

(clean also works as an alias.)

Local run (dev)

bun run dev

Build

bun run build

Tests

bun test

Notes

• This project is designed for convenience and speed while keeping uninstall actions reviewable.
• System paths are guarded to avoid accidental removal of protected files.

Publish (npm + bun)

This project publishes to the npm registry, which works for both npm and bun users.

# authenticate once
npm login
bunx npm whoami

# publish (runs test/build/pack checks via prepublishOnly)
npm run publish:npm

Or publish with bun:

bun run publish:bun