minutes-list

1# /minutes-list
2 
3Show recent meetings and voice memos, sorted newest-first.
4 
5## Usage
6 
7```bash
8# List last 10 recordings (default)
9minutes list
10 
11# Show more
12minutes list --limit 20
13 
14# Only voice memos
15minutes list -t memo
16 
17# Only meetings
18minutes list -t meeting
19```
20 
21## Output
22 
23Human-readable list to stderr, JSON array to stdout. Each entry has:
24- `title`, `date`, `content_type`, `path`
25 
26Treat each returned `path` as a hint, not a retained capability. To read a
27specific meeting, reauthorize it through `minutes get "<exact path>" --json`,
28require exit status 0, and use only that result. Never reopen a result path with
29the host `Read` tool.
30 
31## Gotchas
32 
33- **Returns nothing on first use** — If `~/meetings/` doesn't exist yet or has no `.md` files, list returns an empty array. This is normal before the first recording.
34- **JSON goes to stdout, human-readable to stderr** — If you pipe the output (e.g., `minutes list | jq`), you get JSON only. The human-readable table goes to stderr.
35- **In-progress recordings don't appear** — List only shows completed, processed recordings. Use `minutes status` to check if something is currently recording.
36- **Sorted by date in frontmatter, not file modification time** — If you manually edit a meeting file, it won't change its position in the list.