minutes-cleanup

name	minutes-cleanup
description	Manage old recordings — find large files, archive old meetings, delete processed originals. Use when the user says "clean up recordings", "how much space are meetings using", "delete old recordings", "archive meetings", "manage meeting storage", or asks about disk space from minutes.
triggers	["clean up recordings","how much space are meetings using","delete old recordings","archive meetings","manage meeting storage"]
user_invocable	true
metadata	{"display_name":"Minutes Cleanup","short_description":"Manage old recordings — find large files, archive old meetings, delete processed originals.","default_prompt":"Use Minutes Cleanup for this task.","site_category":"Capture","site_example":"/minutes-cleanup","site_best_for":"Archive or delete old recordings when storage starts piling up."}
assets	{"scripts":[],"templates":[],"references":[]}
output	{"claude":{"path":".claude/plugins/minutes/skills/minutes-cleanup/SKILL.md"},"codex":{"path":".agents/skills/minutes/minutes-cleanup/SKILL.md"}}
tests	{"golden":true,"lint_commands":true}

/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  -mtime +7 -delete 2>/dev/null


 -f ~/.minutes/last-result.json