How caezium/burrow works
Burrow is a system-maintenance and monitoring desktop app, with macOS as its mature native product and Windows preview implementations. The main user workflow is to choose a tool in the app, inspect a scan or preview, then run a cleanup, uninstall, purge, or maintenance action through the bundled engine; destructive operations are consent-gated. Separate capabilities include disk analysis, live status and metric history, and an MCP interface for AI agents. The graph combines README-documented capabilities with sampled engine, history, MCP, and helper relationships; unsampled feature internals are represented at their exact source paths, without inferred call chains.
Main entry points: RootView.swift Tool views · BurrowEngine.swift Engine facade · CleanHub.swift Cleanup tools · MetricsStore.swift Metric history
Components 21
macOS app
- App shell
macos/Sources/App.swift - Tool views
macos/Sources/RootView.swift - Cleanup tools
macos/Sources/CleanHub.swift - App uninstall
macos/Sources/UninstallPlan.swift - Dev artifact purge
macos/Sources/GitSweep.swift - Maintenance
macos/Sources/Maintenance.swift - Disk analysis
macos/Sources/DiskScanner.swift - Live status
macos/Sources/SnapshotProducer.swift
Engine and safety
- Engine facade
macos/Sources/BurrowEngine.swift - Process runner
macos/Sources/EngineRunner.swift - Engine discovery
macos/Sources/EngineCLI.swift - Privileged helper
macos/HelperSources/HelperService.swift
Agents and history
- MCP server
macos/Sources/MCPServer.swift - Metric history
macos/Sources/MetricsStore.swift - Local store
macos/Sources/Store.swift
Windows previews
- Windows shell
windows/App.xaml.cs - Windows tool pages
windows/typescript/src/components/ToolPages.tsx - Windows engine service
windows/Services/MoleEngineService.cs - Windows MCP service
windows/Services/LocalMcpServerService.cs
Other components
- Mac user
- AI agent
Connections 23
- Mac user → App shell: uses
README.md - App shell → Tool views: presents
README.md - Tool views → Cleanup tools: offers cleanup
README.md - Tool views → App uninstall: offers uninstall
README.md - Tool views → Dev artifact purge: offers purge
README.md - Tool views → Maintenance: offers maintenance
README.md - Tool views → Disk analysis: offers analysis
README.md - Tool views → Live status: shows status
README.md - Cleanup tools → Engine facade: runs engine
README.md - App uninstall → Engine facade: runs engine
README.md - Dev artifact purge → Engine facade: runs engine
README.md - Maintenance → Engine facade: runs engine
README.md - Engine facade → Process runner: captures commands
macos/Sources/BurrowEngine.swift - Engine facade → Engine discovery: resolves binary
macos/Sources/BurrowEngine.swift - Cleanup tools → Privileged helper: may elevate
- AI agent → MCP server: queries tools
README.md - MCP server → Metric history: reads history
README.md - Live status → Metric history: records metrics
README.md - Metric history → Local store: persists locally
README.md - Mac user → Windows shell: uses preview
README.md - Windows shell → Windows tool pages: presents tools
- Windows tool pages → Windows engine service: executes commands
- AI agent → Windows MCP service: can query
README.md