Repository navigation
Add podtx summarize for episode summaries and takeaways #8
Description
Summary
Raw transcripts are long. Users often want a short summary, key points, and timestamped quotes without re-listening.
Motivation / evidence
Library already contains hour-long interviews (12k–16k+ words). Manual summarization per episode doesn’t scale.
Proposal
podtx summarize path/to/episode.json
podtx summarize --feed corecursive-coding-stories --limit 5Produce a sidecar summary (e.g. .summary.md or JSON) with:
- short overview
- key points / takeaways
- optional notable quotes with timestamps
Use a pluggable backend (local model and/or API), configured explicitly—no silent external calls.
Out of scope
Full chat-with-podcast UI, automatic publishing to blogs/newsletters.
Acceptance criteria
- Can summarize from existing transcript JSON without re-running ASR
- Output format is stable and documented
- Backend/credentials behavior is explicit and offline-friendly by default where possible
- Docs /
--helpupdated
Activity
frarredondo commentedon Aug 29, 2026
Agent Brief
Category: enhancement
Summary: Add offline-friendly episode summarization (summary + takeaways + timestamped quotes)
Current behavior:
The library stores full interview transcripts (often 12k–16k+ words) as
.json+.txtplus timed segments, and a reformat path already rebuilds outputs without re-running ASR. There is no summarization command; users must read full text or summarize manually per episode.Desired behavior:
A new
podtx summarizecommand generates a stable sidecar summary from existing transcript JSON without re-running ASR. It produces a short overview, key points/takeaways, and optionally notable timestamped quotes. The summarization backend is pluggable and explicitly configured — no silent external network calls — and defaults to an offline-friendly option where possible. Output format is stable and documented, and single-episode and batch-by-feed modes are supported.Key interfaces:
podtx summarize <path/to/episode.json>andpodtx summarize --feed <slug> [--limit N](or equivalent batch flags); credentials/backend selection is explicit via flags/config/env, never implicit.summary.mdor structured JSON) with stable fields for overview, key points, and optional quotes with timestamps; format is versioned/documentedAcceptance criteria:
path/to/episode.json) and batch (--feed <slug> [--limit N]) invocation--helpdescribe invocation, output format, and backend configuration; examples cover single and batch modesOut of scope:
Add podtx summarize with offline fake extractive backend (#8)
Add pragma to summarize ValueError branches for 100% patch (#8)
summarize: add openrouter/opencode/lmstudio backends with Keychain su…
summarize: add openrouter/opencode/lmstudio backends with Keychain (f…
frarredondo commentedon Aug 30, 2026
Shipped by PR #33 (commit
df7409b). Verified against this issue's acceptance criteria:podtx summarize <path>.json)--feed <slug> [--limit N], plus--all).summary.json/.summary.md)fakeextractive, no network;openrouter/opencode/lmstudioopt-in; keys viapodtx auth set, env, or--api-key)--helpmet; README still missing, tracked in Document podtx summarize in README #37Closing as done; the README gap is tracked separately in #37.