/minutes-cleanup

Help the user manage disk space and organize old recordings. Minutes is transcript-first: markdown notes and structured memory are durable, while raw audio is a temporary recovery/reprocessing layer unless pinned.

Check current usage

minutes storage
minutes storage --json

Present this to the user before taking any action.

Common cleanup tasks

Preview raw-audio cleanup

After transcription, the original audio files are no longer needed for search or recap. They only matter if you want to re-transcribe with a better model or debug recovery. Cleanup is preview-only unless --apply is passed.

# Use the configured retention policy
minutes cleanup

# Try a shorter successful-audio window
minutes cleanup --older-than 14d

# Machine-readable preview for agents
minutes cleanup --json

Delete raw audio candidates

Only apply cleanup after showing the preview and getting explicit confirmation.

minutes cleanup --apply
minutes cleanup --older-than 14d --apply

Archive old meetings

Move meetings older than N days to an archive folder:

mkdir -p ~/meetings/archive

# Find meetings older than 90 days
find ~/meetings -maxdepth 1 -name "*.md" -mtime +90

# Move them (confirm with user first)
find ~/meetings -maxdepth 1 -name "*.md" -mtime +90 -exec mv {} ~/meetings/archive/ \;

Archived meetings won't appear in minutes list or minutes search (which only scans ~/meetings/), but they're still on disk if needed.

Clean up processed voice memos

The watcher moves originals to ~/meetings/memos/processed/ after transcription:

du -sh ~/meetings/memos/processed/ 2>/dev/null

Clean up stale state

# Remove stale PID file
rm -f ~/.minutes/recording.pid

# Clean old logs (keep last 7 days)
find ~/.minutes/logs -name "*.log" -mtime +7 -delete 2>/dev/null

# Remove last-result.json (transient)
rm -f ~/.minutes/last-result.json

Gotchas