# Read retained transcripts ```ts Agent or terminal // transcripts.cli; macOS release ├── hex history -> Timestamp, app, recorded mode, final text │ ├── --since / --until / --app / --grep -> Filter, then limit │ ├── --search -> Rank filtered entries with meetings' fuzzy BM25 │ │ (raw + final text count as one document) │ ├── --raw -> Include the stored pre-processing transcript │ ├── --oldest-first -> Reverse timestamp order │ ├── --json -> Version 1 response, with truncation flag │ └── stats [--since/--until] [--json] -> Labs › Dictation stats (labs.history_stats): │ dictations, words, words per minute, changed by Output, daily streak, │ top apps over every retained entry; toggle off -> fails naming │ `hex labs on history-stats` before History is read └── hex meetings ├── list -> Newest first, overlapping time range, live status ├── show -> Markdown or versioned JSON with notes and entries │ ├── --from / --to -> Only entries overlapping │ │ the range, finished or still recording; inverted or past-the-end │ │ ranges fail with an error │ └── --chapter N -> Only chapter N's entries (not with --from/--to) ├── chapters -> Live chapters (experiment live-chapters): │ spans, names, lines, whether corrected; none -> says so; --json └── search -> MCP's stemmed, fuzzy BM25 passages; exact stems first ``` Commands work beside the running app and independently of feature opt-ins, except `hex history stats` (and `meetings show --srt|--vtt`), which need their Labs toggle. `control/transcript_cli` dispatches before logging, instance locking, local API, GUI, permissions, and Hex Microphone. Nothing is created or repaired. Debug `meeting list/show` shares this path; recording remains debug-only. History uses one open-file snapshot and the saved retention, so concurrent atomic replacement cannot expose a partial write and expiry is enforced before disk cleanup. Off retains existing entries. Missing settings default to a week; malformed history/settings fail with an error. The same owner-only store now holds at most 10,000 entries and 16 MiB of raw + final text, without an archive. Already-evicted entries remain unavailable. UI search still returns at most 200; CLI limits apply after filtering and allow up to 10,000. Sources: [control/transcript_cli.rs](../../src/control/transcript_cli.rs), [history.rs](../../src/history.rs), [meeting/query.rs](../../src/meeting/query.rs), and early dispatch in [main.rs](../../src/main.rs). [Command and JSON contracts](../transcript-cli.md) document flags and schema. Checks in [control/transcript_cli_tests.rs](../../src/control/transcript_cli_tests.rs) cover filters/order, ranked `--search` within retention, one document per entry (`history_search_counts_raw_and_final_text_as_one_document`), retention and malformed settings, JSON snapshots, atomic-replace reads, parsing, and `show --from/--to` JSON, Markdown, and errors, including `--to 0` (`meeting_show_ranges_filter_json_entries_and_markdown`), and `chapters` / `show --chapter` JSON and Markdown on the synthetic `tests/fixtures/meetings-chapters` meeting (`meeting_chapters_list_and_select_a_chapter_in_json_and_markdown`). Existing history checks cover bounded storage, owner-only files, and expiry. Meeting query fixtures cover locks, partial NDJSON, interrupted drafts, and search parity with MCP. These fixture checks do not establish a signed installed-app invocation; native install evidence must be recorded separately. `scripts/test-transcript-cli.py ` exercises the real command parser against copied fixtures while holding the listener lock. It checks that the commands create no logs or API discovery file and leave all input bytes and modification times unchanged, with experimental microphone mode requested. Observed October 22, 2026, on Pro before and after the Rune integration: all 35 targeted history, meeting-query, and CLI tests passed; formatting and all-target/all-feature Clippy with `-D warnings` passed. The optimized release binary passed the occupied-lock/no-write smoke. Claude Opus 5.5 reviewed the implementation and integration independently and found no blockers.