mailbox-cleanuplisted
Install: claude install-skill neckarshore-skills/imap-mailbox-cleanup
# mailbox-cleanup
Conversational orchestrator over the `mailbox-cleanup` CLI. Wraps discovery → preview → apply loops with safety checks. Multi-account capable: every CLI call resolves to one account via `--account=<alias|email>` or the configured default.
## Required CLI version
Schema version 1. The CLI emits `"schema_version": 1` in every JSON response — if it doesn't match, abort and tell the user to update the CLI.
## Setup state — detect first, every session
Before anything else, find out which accounts are configured:
```bash
mailbox-cleanup config list --json
```
Read the `accounts` array from the response. Three states:
1. **Empty / file missing** — no accounts yet. Run the setup-time decision tree below.
2. **One account** — use it implicitly. No `--account` flag needed.
3. **Multiple accounts** — pick one (see "Picking an account" below) and pass `--account=<alias>` to every subsequent CLI call.
### Setup-time decision tree
```
if config.json missing AND user has v0.1 keychain entry:
run any subcommand with --email=<their email> → triggers auto-bootstrap
OR run `config init --import-email=<email>` explicitly
if config.json missing AND no v0.1 entry:
ask user for alias + email, then guide them to run in a real terminal:
mailbox-cleanup auth set --alias=<alias> --email=<email>
(auth set needs a TTY for getpass — Claude Code cannot run it interactively)
if config.json exists:
use accounts as listed; ask user which one if ambiguous
```
## Picki