Burrow

Dokumentation

Alles, was Burrow tut, woran jedes Werkzeug rührt, und die Regeln, die es befolgt, bevor es irgendetwas entfernt.

Überblick

Burrow ist eine native Desktop-App für macOS, mit einer WinUI-3-Version für Windows als Beta. Sie übernimmt die Aufgaben, die sonst auf ein Aufräumwerkzeug, einen Deinstallierer, eine Duplikatsuche, eine Festplattenkarte und einen Monitor in der Menüleiste verteilt sind — und öffnet all das über MCP für Coding-Agenten.

Vierzehn Werkzeuge teilen sich ein Fenster. Jedes färbt die Oberfläche in seiner eigenen Farbe, denn die Farbe sagt dir, woran es gleich rührt. Für zwei davon gibt es überhaupt keine Entsprechung auf der Kommandozeile: den Langzeitverlauf und den MCP-Server.

Alles läuft lokal. Scans, Messwerte und Verlauf bleiben auf dem Mac, und der MCP-Server lauscht ausschließlich auf dem Loopback.

Installieren

Auf macOS ist Homebrew der kürzeste Weg. Es installiert die mit Developer ID signierte, von Apple notarisierte Version samt mitgelieferter Engine und behält die Quarantäne bei, damit Gatekeeper das Ticket prüfen kann.

brew install --cask caezium/tap/burrow

Direkte Downloads und die Windows-Vorschau findest du auf der Installationsseite. Updates kommen über einen signierten Sparkle-Feed in der App an; Homebrew-Installationen aktualisierst du mit brew upgrade.

Vollständiger Festplattenzugriff

Ohne ihn führt Burrow einen sicheren Scan aus. Mit vollständigem Festplattenzugriff erreicht es tiefer liegende Application-Support- und Container-Caches, die macOS sonst verbirgt. Du kannst ihn jederzeit in den Systemeinstellungen unter „Datenschutz & Sicherheit“ erteilen oder entziehen.

Platz zurückgewinnen

Bereinigen

Durchsucht mehr als zehn Kategorien: App-Caches, System-Caches, Protokolle, Caches von Entwicklerwerkzeugen, Caches von KI-Werkzeugen, Browserdaten, Cloud-Speicher-Clients, Design-Werkzeuge, Kommunikations-Apps und sonstige temporäre Dateien.

Die Prüfliste ist danach sortiert, wie sicher jeder Eintrag zu entfernen ist. Neu erzeugbare Caches stehen oben, sichtbarer Zustand unten. Die Größenberechnung kennt Hardlinks, sodass Dateien, die sich zwei Werkzeuge teilen, einmal zählen statt einmal pro Pfad.

Tiefenreinigung

Der Aushub, den Entwicklungsarbeit hinterlässt — getrennt von gewöhnlichen Caches, weil die Abwägung eine andere ist. Build-Ausgaben wie dist, build, target, .next, .build, DerivedData, __pycache__ und coverage entstehen lokal und ohne Netz neu. Abhängigkeitsordner wie node_modules, Pods und venv müssen erneut geladen werden; sie werden deshalb mit diesen Kosten angezeigt und bleiben abgewählt, bis du sie bestätigst.

Installationsdateien

Findet .dmg und .pkg -Dateien, die noch lange nach der Installation im Download-Ordner liegen. Einzeln klein, in Summe auf einem seit ein paar Jahren laufenden Mac häufig zweistellige Gigabytebeträge.

Duplikate

Ein gestufter Inhalts-Hash: erst nach Größe gruppieren, dann einen Anfangsteil der Kandidaten hashen und nur das vollständig hashen, was danach noch übereinstimmt. Hardlinks und Klone gelten als ein Objekt, sodass die angezeigte Menge auch die ist, die du wirklich zurückbekommst.

Ähnliche Fotos

Visueller Abgleich für Bilder, die fast gleich aussehen, sich aber Byte für Byte unterscheiden — Serienbilder etwa oder erneute Exporte. Ein Inhalts-Hash sieht die nicht; das hier schon.

Programme

Apps

Jedes installierte Programm, sortierbar nach Größe, Name, letzter Nutzung oder Herkunft. Beim Deinstallieren mehrerer auf einmal verschwindet das Bundle samt Einstellungen, Application-Support-Daten, Containern, gesichertem Zustand und Launch Agents.

Ein Homebrew-Tab prüft, welche Casks und Formulae veraltet sind, und kann sie an Ort und Stelle aktualisieren. Burrow löst dabei das Cask-Token auf statt den angezeigten Namen, weil ein Dutzend verbreiteter Apps Tokens benutzt, die anders lauten als der Name der App.

Reste

Die andere Richtung: zugehörige Dateien, Einstellungen und Launch Agents von Programmen, die längst weg sind. Burrow ordnet jede verwaiste Datei der App zu, die sie hinterlassen hat — du bestätigst also die Reste einer benannten App statt einer Liste von Pfaden.

Launch Agents gelöschter Apps lohnen sich zuerst. launchd versucht weiter, ein Programm zu starten, das es nicht mehr gibt — und erzeugt bei jedem Start Rauschen im Protokoll.

Wartung

Optimieren

Die Routinearbeiten, gebündelt hinter einer Abfrage: Quick Look neu aufbauen, Caches und Metadaten reparieren, DNS leeren und Anmeldeobjekte prüfen.

Feinschliff

Rundum-Pflege in einem Durchgang. Burrow wählt die Wartung, die auf diesen Mac gerade wirklich zutrifft, und führt sie vollständig aus, statt eine feste Liste anzubieten, die meist nicht passt.

Die Festplatte verstehen

Analysieren

Eine Treemap des ganzen Volumes, skaliert nach tatsächlich belegten Bytes. Steig in jeden Zweig hinab, um dieselbe Aufschlüsselung eine Ebene tiefer zu sehen, und zeig ihn dann im Finder oder leg ihn aus dem Kontextmenü in den Papierkorb.

Auf die Frage „was belegt meine Festplatte“ antwortet eine Treemap besser als eine sortierte Liste, weil der größte Verbraucher die größte Fläche ist statt die erste Zeile, zu der du erst scrollen musst.

Wenn der freie Platz nach dem Löschen von etwas Großem nicht wächst, halten das meist lokale Time-Machine-Schnappschüsse fest. Siehe warum dein Mac die Festplatte für voll hält, obwohl sie es nicht ist.

Den Mac beobachten

Status

CPU, Arbeitsspeicher, GPU, Festplatte, Netzwerk und Batterie auf einer Seite, jeweils mit Verlaufskurve. Die Prozessliste sortiert nach jeder Spalte und heftet die Zeilen an, die im Blick bleiben sollen. Auf Apple Silicon werden Lüfterdrehzahl und Chiptemperaturen nativ aus dem SMC gelesen.

Verlauf

Jede Messung, die Status nimmt, landet in einer lokalen SQLite-Datei. Spul von fünf Minuten bis neunzig Tage zurück, mit Spitzenwerten je Prozess für die Momente, in denen die Lüfter wirklich hochgingen. Nichts wird hochgeladen.

Ports

Zeigt jeden offenen Port mit Prozess, Programmpfad und zugehörigem Benutzer, laufend aktualisiert. So siehst du, was Port 3000 belegt, ohne lsof auszuführen.

Netzwerk

Live-Durchsatz pro Schnittstelle und pro Prozess. Anders als die aufsummierten Werte der Aktivitätsanzeige ist das eine Rate — der Prozess, der deine Leitung gerade auslastet, steht also oben.

Wieder online

Ein geführter Weg zurück an die Oberfläche, wenn die Verbindung abreißt: Zustand der Schnittstelle, DNS-Auflösung, Erreichbarkeit des Gateways und Erkennung einer Anmeldeseite, der Reihe nach geprüft.

Das ganze Bild klappt aus der Menüleiste herunter, ohne die App zu öffnen: Live-Messwerte, Top-Prozesse und ein Sprung in das Werkzeug, das du gerade brauchst.

Agenten und MCP

Burrow ist zugleich ein MCP-Server, sodass ein Coding-Agent den Mac befragen kann, statt aus deinem Quelltext zu raten. Sechsundzwanzig Werkzeuge stehen bereit. Vierzehn lesen nur und sind sofort verfügbar; die, die deinen Mac verändern, brauchen jeweils eine eigene ausdrückliche Freigabe in den Einstellungen, bevor ein Agent sie überhaupt aufrufen kann.

Richte Claude Code auf die App:

{
  "mcpServers": {
    "burrow": {
      "command": "/Applications/Burrow.app/Contents/MacOS/Burrow",
      "args": ["--mcp"]
    }
  }
}

Nur lesende Werkzeuge

burrow_snapshot, burrow_history, burrow_top_processes, burrow_process_usage, burrow_info, burrow_analyze, burrow_dupes, burrow_orphans, burrow_photos, burrow_ports, burrow_net, burrow_doctor, burrow_disk_forecast und burrow_list_apps.

Freizuschaltende Werkzeuge

burrow_clean, burrow_purge, burrow_uninstall, burrow_optimize und burrow_installer verändern den Mac und bleiben unerreichbar, bis du sie einschaltest.

HTTP API

Eine HTTP-API auf dem Loopback unter 127.0.0.1:9277 liefert dieselben nur lesenden Daten für Werkzeuge, die HTTP statt MCP sprechen. Sie ist standardmäßig an und lässt sich in den Einstellungen abschalten. Sie lauscht ausschließlich auf dem Loopback und ist von einem anderen Rechner aus nie erreichbar.

Sicherheitsmodell

Burrow ist so gebaut, dass ein Fehler dich einen erneuten Build kostet und nicht deine Daten. Vier Regeln gelten überall in der App.

  • Erst zeigen, dann löschen. Jede Aktion listet Dateien und Bytes auf, bevor sich etwas bewegt. Du bestätigst, Burrow handelt.
  • Nach Tragweite sortiert. Die Kategorien sind danach geordnet, wie sicher sie zu entfernen sind, und alles mit echten Kosten fürs Neuerzeugen bleibt abgewählt, bis du es selbst ankreuzt.
  • Kein Root-Helfer im Hintergrund. Braucht eine Aufgabe Administratorrechte, fragt dich der Autorisierungsdialog von macOS selbst, Burrow führt genau diesen einen Befehl aus, und der Prozess endet. Es bleibt kein privilegierter Dienst zurück.
  • Eine Schutzliste, die du lesen kannst. Pfade, die nie zum Entfernen infrage kommen, sind im Code erzwungen und nicht bloß Konvention — und der Quelltext ist öffentlich.

Signatur und Notarisierung

Version 0.11.0 und jede spätere macOS-Version ist mit Developer ID signiert und von Apple notarisiert, und ein Tag kann nur veröffentlichen, wenn Signatur, Notarisierung, Ticket-Anheftung und Gatekeeper-Prüfung sämtlich gelingen. Archivierte Builds bis 0.10.5 stammen aus der Zeit vor dieser Zusage: Rechtsklick und „Öffnen“ wählen, falls Gatekeeper eine blockiert.

Datenschutz und Telemetrie

Keine Dateien, Pfade, URLs oder Messwerte verlassen den Mac. Scans, Verlauf und der MCP-Server sind vollständig lokal.

Burrow sendet allerdings anonyme, abschaltbare Nutzungs- und Diagnosedaten: Berichte über Abstürze und Hänger, Ergebnisse von Start und Update sowie stichprobenartige Leistungsmessungen mit festen Namen. Es zeichnet nie den Bildschirm auf und sendet nie Dateien der Nutzenden oder deren Inhalte. Ein Schalter in den Einstellungen stoppt beide Dienste, und aus dem Quelltext gebaute Versionen senden von vornherein nichts.

Jedes Feld ist aufgeführt in TELEMETRY.md. Diese Website nutzt davon unabhängig eine Analyse ohne Cookies, die kein Personenprofil anlegt, keine Browserkennung speichert, Abfragen und Fragmente aus der URL entfernt und Do Not Track beachtet.

Fehlerbehebung

Gatekeeper blockiert die App

Ab 0.11.0 sollte das nicht passieren; tut es das doch, wurde der Download unterwegs vermutlich verändert — lade ihn dann erneut von GitHub. Bei archivierten Builds: Rechtsklick auf die App und „Öffnen“ wählen.

Der Festplattenzugriff sieht erteilt aus, die Scans bleiben aber flach

macOS knüpft die Erlaubnis an die Codesignatur der App. Ersetzt du die App durch eine anders signierte Version, verfällt sie. Entferne Burrow aus der Liste für den vollständigen Festplattenzugriff und füge es erneut hinzu.

Der freie Speicher ist nicht gewachsen

Eine Datei zu löschen gibt keine Blöcke frei, auf die ein lokaler Time-Machine-Schnappschuss noch verweist. macOS dünnt die Schnappschüsse bei Platzmangel automatisch aus. tmutil listlocalsnapshots / zeigt, was vorhanden ist.

Ein Agent sieht die freizuschaltenden Werkzeuge nicht

Bereinigen, Deinstallieren und die übrigen handelnden Werkzeuge bleiben verborgen, bis du Agentenaktionen in den Einstellungen aktivierst. Das ist Absicht: Ein Agent soll nichts löschen können, das du nicht eigens freigegeben hast.