IMAP Mailbox Cleanup

GitHub

Hybrid aus CLI und Claude-Skill für die Triage großer IMAP-Postfächer. Räumt nach klaren Regeln auf — dry-run als Default, jede Aktion audit-logged. Läuft gegen dein eigenes Postfach (IONOS getestet), ohne Cloud-Zwischenstopp.

dry-runZeigt erst, was passieren würde — nichts wird ohne explizite Bestätigung verschoben oder gelöscht.
rule-triageSortiert, archiviert und löscht nach konfigurierbaren Regeln: Absender, Alter, Betreff, Ordner.
audit-logProtokolliert jede Aktion nachvollziehbar — volle Transparenz, reproduzierbar.
imap-nativeSpricht direkt per IMAP mit dem Server (IONOS getestet). Deine Mails verlassen das Postfach nicht.
BetaMIT License

Was ist IMAP Mailbox Cleanup?

Ein über Jahre gewachsenes Postfach lässt sich nicht in einer Sitzung von Hand bändigen. IMAP Mailbox Cleanup macht die Triage zu einem regelbasierten, nachvollziehbaren Vorgang: Du beschreibst, was weg soll — nach Absender, Alter, Betreff oder Ordner — und das Tool zeigt erst, was passieren würde, bevor irgendetwas bewegt wird. In einer realen Sitzung schrumpfte ein IONOS-Postfach so von 7.982 auf 690 Nachrichten (−91 %), ohne dass etwas unwiederbringlich verloren ging.

CLI + Skill: warum hybrid

Eine reine CLI würde dich Subcommands auswendig lernen und JSON lesen lassen; ein reiner Skill würde die IMAP-Logik in Markdown drücken — fragil und untestbar. Der Hybrid hält die Engine testbar und die Bedienung konversationell:

CLIPython mit click und imap-tools: atomare Subcommands mit JSON-Ausgabe, zustandslos und testbar (pytest gegen einen echten IMAP-Server in Docker). Auch allein nutzbar.
Claude-SkillKonversationeller Orchestrator, der die CLI in einer Discovery → Preview → Apply-Schleife führt — und vor jeder destruktiven Aktion fragt.

Sicherheitsmodell

Das Tool führt destruktive Operationen auf deinem Postfach aus — deshalb ist Sicherheit eingebaut, nicht optional:

dry-runJeder destruktive Subcommand ist standardmäßig ein Dry-run. Erst --apply tut wirklich etwas.
soft-deleteLöschen verschiebt nach Papierkorb / Trash (RFC-6154-Special-Use mit Fallbacks). Kein EXPUNGE in v1 — nichts wird hart gelöscht.
audit-logJede --apply-Aktion hängt eine JSON-Zeile an: Zeitstempel, Account, Argumente, Ordner, betroffene UIDs, Ergebnis.
keychainPasswörter liegen im macOS-Keychain (via keyring) — kein .env, kein Klartext. Pro E-Mail ein Eintrag.

Datenschutz & Verfügbarkeit

Das Tool läuft direkt zwischen deiner Maschine und deinem IMAP-Server — kein Cloud-Zwischenstopp, keine Kopie deiner Mails irgendwo anders. Passwörter liegen im System-Keychain, jede Aktion im lokalen Audit-Log. Es ist Open Source unter MIT-Lizenz und frei auf GitHub verfügbar; der Link unten führt direkt zum Repository.

Häufige Fragen

Was ist IMAP Mailbox Cleanup?+

Ein Hybrid aus Kommandozeilen-Tool und Claude-Code-Skill, der ein IMAP-Postfach nach konfigurierbaren Regeln triagiert und aufräumt. Die CLI macht die Arbeit (zustandslos, testbar), der Skill führt dich konversationell durch Discovery, Vorschau und Anwendung. Open Source unter MIT-Lizenz.

Kann es versehentlich Mails löschen?+

Der Default ist Dry-run — es passiert nichts, bis du explizit --apply setzt. Gelöscht heißt Soft-Delete in den Papierkorb (kein EXPUNGE in v1), und der Skill zeigt vor jeder destruktiven Aktion erst die Vorschau aus einem Dry-run und fragt nach. Jede Aktion landet zusätzlich im Audit-Log.

Wo liegen meine Zugangsdaten?+

Im macOS-Keychain (über keyring), ein Eintrag pro E-Mail-Adresse — kein .env, kein Klartext. Verbindungseinstellungen liegen in einer lokalen Config-Datei mit Mode 0600. Das Tool ist mehr-Account-fähig.

Funktioniert es mit meinem Anbieter?+

Es spricht Standard-IMAP und wurde gegen IONOS-Postfächer entwickelt und getestet — in einer realen Sitzung von 7.982 auf 690 Nachrichten (−91 %). Andere IMAP-Anbieter sind grundsätzlich möglich; getestet ist primär IONOS.

Wie dieser Text entstand: KI-beschleunigt aus der README und Repo-Dokumentation des Projekts zusammengestellt, vom Gründer redigiert.