minutes-cleanup

1# /minutes-cleanup
2 
3Help the user manage disk space and organize old recordings. Minutes is
4transcript-first: markdown notes and structured memory are durable, while raw
5audio is a temporary recovery/reprocessing layer unless pinned.
6 
7## Check current usage
8 
9```bash
10minutes storage
11minutes storage --json
12```
13 
14Present this to the user before taking any action.
15 
16## Common cleanup tasks
17 
18### Preview raw-audio cleanup
19 
20After transcription, the original audio files are no longer needed for search or
21recap. They only matter if you want to re-transcribe with a better model or
22debug recovery. Cleanup is preview-only unless `--apply` is passed.
23 
24```bash
25# Use the configured retention policy
26minutes cleanup
27 
28# Try a shorter successful-audio window
29minutes cleanup --older-than 14d
30 
31# Machine-readable preview for agents
32minutes cleanup --json
33```
34 
35### Delete raw audio candidates
36 
37Only apply cleanup after showing the preview and getting explicit confirmation.
38 
39```bash
40minutes cleanup --apply
41minutes cleanup --older-than 14d --apply
42```
43 
44### Archive old meetings
45 
46Move meetings older than N days to an archive folder:
47 
48```bash
49mkdir -p ~/meetings/archive
50 
51# Find meetings older than 90 days
52find ~/meetings -maxdepth 1 -name "*.md" -mtime +90
53 
54# Move them (confirm with user first)
55find ~/meetings -maxdepth 1 -name "*.md" -mtime +90 -exec mv {} ~/meetings/archive/ \;
56```
57…