Skip to content
MinuteHaul

MinuteHaul CLI: free open-source tl;dv transcript exporter

A single-file, zero-dependency Node.js script (MIT license). It lists all your tl;dv meetings through the official API and writes one Markdown file per transcript, plus a CSV index and one combined text file.

Run it

curl -O https://minutehaul.haullabs.dev/cli/minutehaul.mjs
export TLDV_API_KEY=your_key   # from tldv.io/app/settings/personal-settings/api-keys
node minutehaul.mjs --out ./tldv-export --notes

# optional: --from 2026-01-01 --to 2026-06-30 --jsonl

Avoma (beta)

export AVOMA_API_KEY="CLIENT_KEY:CLIENT_SECRET"   # Avoma admin: Settings > Organization > Developer
node minutehaul.mjs --source avoma --out ./avoma-export

Avoma support has been tested against a mock of Avoma's published API, not yet a live account. See the Avoma bulk export guide for requirements (Avoma's API is on its Organization plan and above).

Files: minutehaul.mjs (source) · LICENSE (MIT). Retries on 429/5xx with backoff. Meetings without a finished transcript are listed as skipped in index.csv.

No terminal? The web exporter does the same in your browser and gives you a ZIP. It is free for your 10 most recent meetings, or $29 one-time for unlimited (pre-order).

FAQ

Is the CLI really free?

Yes. It is MIT-licensed and exports every meeting your API key can reach, with no meeting cap. The paid web app is for people who prefer a one-click ZIP in the browser over a terminal.

What do I need to run it?

Node.js 18 or newer and a tl;dv API key. API access depends on the meeting organizer's tl;dv plan; tl;dv's API docs list Pro, Business and Enterprise.

Does the CLI send my data to MinuteHaul?

No. It talks only to tl;dv's API (pasta.tldv.io) and writes files to your disk. Read the single source file before you run it.

What files does it create?

transcripts/*.md (one Markdown file per meeting), index.csv, all-transcripts.txt, and optionally all.jsonl (--jsonl). Add --notes to include tl;dv's AI notes.

More: tl;dv API transcripts guide · API field reference.