About this project

Glomeris is a developer-focused storage management tool designed specifically for macOS. It operates as an "autopilot" to help resolve disk pressure by discovering meaningful, reclaimable storage without disrupting active work. Key features include: - **Evidence-First Approach**: The tool analyzes actual filesystem data to determine what can be safely removed, rather than relying on generic cache lists or simple size metrics. - **Policy-Constrained Safety**: Glomeris enforces strict policies where AI can only recommend from a closed set of known, typed cleanup actions. It cannot invent commands or delete protected resources. The executor verifies actions against the filesystem reality. - **BYOK LLM Support**: Users can optionally bring their own key (BYOK) to configure an LLM planner. This model helps rank and explain ambiguous candidates but remains constrained by the safety policy. - **Targeted Cleanup**: Users can specify a target amount of free space (e.g., 10GB), and Glomeris will execute approved actions until the target is reached or no safe actions remain. The project is currently an experimental MVP. Installation requires building from source using Rust/Cargo, with prebuilt macOS releases planned for future updates. Documentation covers the safety model, emergency modes, and architecture in detail.