ABOUTME: Gmail bulk cleanup - archive old emails, delete promotions, free storage
ABOUTME: Parameterized batch operations with safety-first approach
Email Cleanup Skill
Gmail: See ../_GMAIL.md for account config and commands.
Safety Rules
- NEVER delete without confirmation - show counts first
- Archive over delete - prefer archiving (recoverable)
- Batch in chunks - max 50 at a time
Cleanup Targets
| Category | Query | Action |
|---|---|---|
| Promotions | category:promotions older_than:30d | Archive |
| Social | category:social older_than:14d | Archive |
| Read updates | category:updates is:read older_than:7d | Archive |
| Large emails | larger:10M | Review individually |
| Unsubscribe candidates | unsubscribe is:read older_than:30d | Review |
Workflow
Step 1: Count each category
gog gmail search "<query>" --account=maroffo@gmail.com --json | jq '.resultSizeEstimate'Step 2: Present summary table with counts and suggested actions
Step 3: Execute (with confirmation)
THREADS=$(gog gmail search "<query>" --account=maroffo@gmail.com --json --max=50 | jq -r '.threads[].id')
for tid in $THREADS; do
gog gmail thread modify $tid --account=maroffo@gmail.com --remove-labels=INBOX
doneProcess in batches of 50. Report progress.
Quick Stats
gog gmail labels get INBOX --account=maroffo@gmail.com
gog gmail labels get CATEGORY_PROMOTIONS --account=maroffo@gmail.com