Skip to content

v0.1.0 — first public release

Choose a tag to compare

View all tags
@github-actions github-actions released this 11 Jul 12:15
v0.1.0
88041b0

First public release. 🎬→📋

talkthrough-mcp is a local-first MCP server that turns narrated screen recordings (or any video/audio file) into agent-ready structured data: timestamped transcript, scene keyframes, OCR'd on-screen text, and wall-clock anchoring — so "the moment I said the checkout hung" maps straight to the right window of your server logs. No LLM inside, no cloud anywhere in the path.

uvx talkthrough-mcp

Highlights

  • 7 lazy retrieval tools — a 30-minute recording never floods the context window; agents pull exactly the transcript slice, moment bundle, or frame they need. Every tool description embeds 10–15 usage examples.
  • 5 workflow prompts — triage-recording, spec-from-workshop, backlog-from-demo, meeting-actions, correlate-with-logs — plus a findings JSON contract.
  • Wall-clock anchoring (the flagship): every timestamp carries real ISO-8601 time resolved from recording metadata, with an honest confidence ladder.
  • Any of Whisper's ~99 languages, auto-detected with a confidence signal; per-call model choice (large-v3-turbo recommended for non-English). OCR script packs for non-Latin on-screen text.
  • One-command install, no system dependencies: bundled ffmpeg fallback, pip-only OCR, self-downloading models. Works with Claude Code/Desktop, Cursor, Codex CLI, Gemini CLI, Cline, and any MCP stdio client — 12 engine adapters included.
  • Private by design: recordings never leave your machine; the only network access is one-time model downloads. See SECURITY.md for the threat model.

Not in v1 (roadmap)

Speaker diarization (#4) · URL/YouTube ingestion (#5) · whisper.cpp backend (#6). Contributions welcome — each issue carries a design sketch.

Full changelog: CHANGELOG.md

Assets 4
Loading