Your meeting becomes a note without leaving your machine

Download and unzip

Go to the Skool post, download crunchlog-2.0.0a1.zip and unzip it. The easiest way, recommended by the author, is to let Claude Code install it: open a terminal in the folder, run claude and paste:

I have extracted CrunchLog into this folder. Read START-HERE.md and AGENTS.md and install it for me, then run the demo so I get my first note.

It follows the AGENTS.md from the zip, asks four questions (notes folder, far device, microphone, summary provider) and finishes with the demo. If you prefer to do it by hand, follow the steps below.

Install as a uv tool

Inside the unzipped folder. [mcp] already includes the MCP server; use ".[mcp,tray]" if you want the tray icon.

uv tool install --python 3.12 ".[mcp]"
crunchlog --version   # crunchlog 2.0.0a1 (build 1daf268 of 2026-10-04)

If command not found appears, run uv tool update-shell and open another terminal.

Configure and download the models

Writes the config, the glossary and the summary template, and downloads ~700 MB of models (Parakeet, silero, pyannote, TitaNet). Enter accepts the defaults.

crunchlog devices                  # far and mic device numbers
crunchlog setup                    # or: --yes --provider none (no questions)
crunchlog doctor                   # exit 0 and no [fail] = ready to record

On macOS, the first recording asks for two permissions for crunchlog-audio: Microphone and Screen & System Audio Recording. Without the second, the far track is silent.

First note: the demo

The computer's voice acts out an invented meeting with three people and the real pipeline processes everything. No microphone needed.

crunchlog demo          # Windows / macOS
crunchlog-linux demo    # Linux (Piper), see the Linux section
# turns: 33 turns, talk seconds per role {'Me': 53.8, 'Speaker 2': 55.5, 'Speaker 3': 29.0}
# done in 57 s
# note: ~/CrunchLog/notes/2026-10-05-1642-demo.md

Record a real meeting

Bind crunchlog toggle to a key: PowerToys or AutoHotkey with crunchlogw toggle on Windows, a Shortcuts app shortcut on macOS, or a Stream Deck action. Press it when the call starts and again when it ends.

crunchlog toggle                            # start
crunchlog toggle                            # stop and write the note
crunchlog start --slug acme --speakers 3     # folder name + total number of people (including you)
crunchlog check-audio --tone                # tests both tracks before the 1st call

Import audio or video you already have

mp3, m4a, mp4 and wav come in as the far track (no "Me"). We tested with the author's 2:26 walkthrough: note ready in 18 s.

crunchlog process reuniao.mp4
crunchlog watch ~/Gravador                  # processes everything that lands in the folder

Summary and questions with Claude or Codex

In ~/.config/crunchlog/config.toml, change the provider. CrunchLog calls claude -p (or codex) with tools and MCP turned off, and this comes out of your subscription. Measured: demo summary in 10.3 s.

# config.toml
[summary]
provider = "claude"        # none | claude | codex | auto
claude_model = "opus"
claude_effort = "medium"

crunchlog ask latest "What was decided about the beta launch?"
# The beta starts on November 12 with 200 testers ... [01:13 Me]

Adjust the note afterwards

Give the speakers names, add your own notes, export subtitles or open it in Obsidian.

crunchlog speakers <recording> "Speaker 2=Dana" "Speaker 3=Lee"
crunchlog note "client wants a proposal by Friday"
crunchlog export ~/CrunchLog/recordings/<recording> --format srt   # srt|vtt|txt|json|csv|md
crunchlog templates use standup
crunchlog open latest --obsidian

Cheatsheet before the next meeting

Gathers open action items, decisions and questions from a client's latest notes into one sheet, with guide questions that tick themselves off when the next note answers them. It doesn't call any model.

crunchlog prep "acme" --calendar "Thu 2pm, Ana and Bruno"
# ~/CrunchLog/notes/2026-10-05-acme-cheatsheet.md

Dashboard in the browser

Recorder with level meters, waveform of both tracks, clickable transcript, speaker renaming, prompts, settings and doctor. It only listens on 127.0.0.1. On the first visit, use the link with ?t=... that it prints.

crunchlog dashboard     # http://127.0.0.1:47431/  (--port changes it)

MCP: ask about your meetings in Claude Code

Once registered, ask "what did we agree with Acme on Tuesday?" or "start recording". We tested over stdio and the server answered with 15 tools: status, list_recordings, get_transcript, get_note, get_summary, search_notes, prep, cheatsheet, start/stop/toggle_recording, process, rename_speakers, export and doctor.

claude mcp add crunchlog -- crunchlog mcp

If you use Jack Roberts' Claude OS (Agentic OS lesson, members only), one command registers the MCP and creates a vault that the Memory page syncs:

crunchlog connect agentic-os --dry-run    # shows what it will do
crunchlog connect agentic-os              # --status | --undo

Live mode (alpha, off by default)

Sends both tracks to AssemblyAI (your own paid account) and shows, during the call, the cheatsheet ticking itself off, block summaries and an "ask the meeting" box. The final note still comes from the local pipeline. Don't turn it on for confidential calls.

[live]
enabled = true
provider = "assemblyai"
api_key = "..."     # your key