CappyDisk

CappyDisk is a native macOS disk space manager built with Swift and SwiftUI. It helps you understand what is taking up space, decide what is safe to remove, and stage reviewed cleanup items before moving them to the macOS Trash.

Clean your disk without nuking your life.

What It Does

• Scans folders and drives for disk usage
• Shows a DaisyDisk-style radial map
• Provides a searchable file list with safety filters
• Labels items as low-risk, review-needed, or protected
• Lets you right-click items and add them to a cleanup queue
• Moves queued items to Trash instead of deleting immediately
• Includes a metadata-only AI inspector for explaining selected files and folders

AI And Privacy

CappyDisk does not send your whole disk to AI. AI explanations run only when you explicitly press Explain or choose Explain with AI from the context menu.

By default, CappyDisk uses local rules only. You can optionally configure:

• OpenAI / ChatGPT
• Claude
• Local OpenAI-compatible endpoints such as LM Studio or OpenWebUI

The current AI inspector sends metadata only, such as path, size, kind, modified date, and local safety rule.

Status

This is an early native macOS prototype. It works, but it is not a polished 1.0 release yet. Expect sharp edges around very large scans, app signing, and settings persistence.

Run From Source

swift run CappyDisk

For faster local iteration, skip Swift's index store:

swift run --disable-index-store CappyDisk

Or use the helper script:

./scripts/run_dev.sh

Requires macOS 14 or newer and a recent Xcode/Swift toolchain.

Build A Test DMG

./scripts/package_dmg.sh 0.1.0

The DMG appears in:

.release/CappyDisk-0.1.0.dmg

For public distribution, sign and notarize the app with an Apple Developer ID. See RELEASE.md.

Current Features

• Recursive metadata scanner
• Two-phase scan progress: discovery, then metadata scanning
• Radial disk map visualization
• Searchable file list and safety filters
• Local safety rule engine
• OpenAI, Claude, and local AI provider support
• Explicit AI actions only
• Cleanup queue with Trash-based removal
• OLED-style dark UI with animated terminal Cappy

Roadmap

• Keychain-backed API key storage
• SQLite-backed scan cache and lazy folder loading
• Signed/notarized app bundle
• Better handling for enormous folders
• Duplicate finder
• Disk growth history
• Finder extension