Burrow  by caezium

macOS disk utility with AI agent integration

Created 3 weeks ago

New!

744 stars

Top 46.0% on SourcePulse

GitHubView on GitHub
Project Summary

A free, open-source, native macOS GUI for the mo CLI, Burrow simplifies disk cleaning, app uninstallation, and system monitoring. It enhances the CLI with long-term metric history and an MCP server for AI agent integration, offering a user-friendly interface for Mac maintenance and analysis.

How It Works

Burrow wraps the mo CLI engine in a native macOS application, providing a GUI for tasks like junk cleaning, dev artifact purging, app uninstallation, and disk analysis. Its core innovations include a local SQLite database for long-range system metric history (unavailable in the CLI) and an MCP server enabling AI agents (e.g., Claude Code, Cursor) to query the Mac's recent state and historical data. Data flows from mo CLI outputs (mo status --json, mo analyze --json) into Burrow's display, history logging, and MCP server components.

Quick Start & Requirements

  • Requirements: macOS 14+; mo CLI (brew install mole) is mandatory.
  • Installation:
    • Homebrew: brew install mole then brew install --cask caezium/tap/burrow.
    • Direct Download: Download Burrow-x.y.z.zip, unzip to /Applications, run xattr -cr /Applications/Burrow.app.
    • Build from Source: Requires xcodegen, mole. Clone, xcodegen generate, xcodebuild, copy, xattr -cr.
  • Links: Releases page (implied), SECURITY.md, TELEMETRY.md.

Highlighted Details

  • AI Agent Integration: Features an MCP server (stdio/localhost HTTP) allowing AI agents (Claude Code, Cursor, Codex) to query Mac system history and status via tools like burrow_snapshot and burrow_history.
  • Long-Term Metric History: Stores system metrics (CPU, Memory, Disk, etc.) in a local SQLite DB for up to a year, offering historical charts and peak-per-process data absent in the CLI.
  • Comprehensive System Tools: Integrates mo CLI functions for cleaning, dev artifact purging, installer management, software uninstallation (incl. Homebrew updates), and disk analysis (treemap).
  • Live System Monitor: Provides a real-time dashboard with sparklines and process tables for key system vitals.

Maintenance & Community

Burrow is an independent, open-source project (MIT license) distinct from the official mole.fit app. No specific community links or contributor details are provided in the README.

Licensing & Compatibility

  • License: MIT for Burrow and the mo CLI.
  • Compatibility: MIT license permits commercial use and linking.

Limitations & Caveats

  • Unsigned (Pre-1.0): Releases are unsigned, requiring manual quarantine clearing (xattr -cr). Notarization is pending.
  • Full Disk Access: Requires granting Full Disk Access for full functionality, with user-prompted elevation options.
  • macOS 14+: Strictly limited to macOS 14 (Sonoma) and newer.
Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
90
Issues (30d)
92
Star History
747 stars in the last 24 days

Explore Similar Projects

Feedback? Help us improve.