A fast, native macOS disk space analyzer that helps you find where your storage is going. Scan any folder or volume, explore results with an interactive sunburst chart and file browser, and clean up — all without leaving the app. Take a look at Radix's beautiful website!

Storage fills up quietly. Radix makes it obvious where it went — no Terminal commands, no waiting through recursive scans that crawl forever. Point it at a folder, sit back, and explore a visual breakdown of every directory and file.

It's built from scratch in Swift and SwiftUI, designed to feel like a natural part of macOS.

• Iterative file system traversal — no recursion, no stack overflows, no hanging on deep node_modules
• Real-time progress with smooth, blended metrics so you actually know how far along things are
• Auto-summarization — directories with thousands of tiny files get collapsed into a single node, keeping scans fast and the UI clean
• Respects permissions — works on ordinary folders without special privileges; warns you when protected paths (Mail, Safari, Messages) are skipped

• Sunburst chart — a radial treemap that shows your disk usage at a glance. Hover any segment to see what it is, double-click to drill down.
• File browser — a sortable table with Name, Size, Kind, File Count, and Modified Date columns.
• Smart search — filter just the current folder, or search the entire scan tree.
• Breadcrumb navigation with back/forward history so you don't lose your place.

• Native SwiftUI app — no web views, no Electron
• Sidebar with Smart Locations (Macintosh HD, mounted volumes, Home, Desktop, Documents, Downloads, Library, Applications) and recent scans
• Inspector panel showing detailed metadata: allocated vs. logical size, parent directory, access level, largest children
• File actions — Reveal in Finder, Open, Copy Path, Move to Trash, all from context menus or the inspector
• Drag & drop any folder into the window to scan it
• Automatic updates powered by Sparkle

Radix works out of the box on any folder you can already access. For folders like ~/Library or Mail data, macOS may require Full Disk Access. Radix detects when files are skipped due to permissions and guides you through enabling it in System Settings — one click, no guesswork.

• macOS 14.0 (Sonoma) or later
• Xcode 26+ with Swift 6.0 toolchain (for building from source)

Grab the latest release from the Releases page. Drag Radix into your Applications folder, and you're done.

Open Radix > Settings (or press Cmd + ,) to adjust:

# Clone the repository
git clone https://github.com/colinvkim/radix.git
cd radix

# Build and run package tests
swift test

# Open in Xcode for the full app
open Radix.xcodeproj

The Package.swift file contains the RadixCore library (scan engine, models, geometry, formatters) and has no external package dependencies. The full SwiftUI app is built through the Xcode project, which integrates Sparkle through Xcode's Swift Package Manager support. Use SwiftPM for the package test suite and Xcode for the app build:

swift test
xcodebuild -project Radix.xcodeproj -scheme Radix -configuration Debug -destination 'platform=macOS' build

The shared Radix app scheme is not configured with an Xcode test action because the tests belong to the SwiftPM RadixCoreTests target.

Radix/
├── App/                  # App entry point, commands, window management
├── Models/               # Core data types (FileNodeRecord, ScanSnapshot, etc.)
├── Services/             # Scan engine, sunburst geometry, formatters
├── ViewModels/           # AppModel — central state manager
├── Features/             # UI features (workspace, sidebar, file browser,
│   ├── Workspace/        #   visualization, inspector, settings, onboarding)
│   ├── Sidebar/
│   ├── FileList/
│   ├── Visualization/
│   ├── Inspector/
│   ├── Settings/
│   └── Onboarding/
└── Shared/               # Reusable components (breadcrumbs, helpers)

• ScanEngine is an actor-based async scanner that uses iterative (not recursive) filesystem traversal for safety and performance.
• AppModel is the single source of truth — a @MainActor observable object that drives the entire UI.
• ScanSnapshot and FileTreeStore provide immutable scan results with O(1) path lookups, flat tree storage, and efficient subtree updates.
• The sunburst chart is rendered using SwiftUI's Canvas API for performant drawing of hundreds of segments.
• RadixCore has no external Swift package dependencies; the Xcode app target adds Sparkle for automatic updates.

Contributions are welcome. Here's how to get started:

1. Fork the repo and create a feature branch
2. Make your changes — keep them focused and well-documented
3. Run the tests: swift test
4. Open a pull request with a clear description of what changed and why

If you're tackling something big, consider opening an issue first to discuss the approach.

MIT. See LICENSE for details.