agent-fathom

Fathom meeting intelligence CLI for AI agents

Language
Go
Version
0.2.1
License
PolyForm Perimeter 1.0.0
Category
CLI Tool

A read-first CLI over Fathom, the AI notetaker. It turns "what did we agree with Acme last week?" and "what did we commit to on that call?" into single commands that emit compact, structured output — transcripts per utterance, action items per commitment, summaries and highlights — so an LLM can answer them without ever seeing a credential.

Features

01

Question-shaped commands — list by date, company domain, attendee, recorder, team or meeting type rather than by endpoint

02

Client-side search inside the paging loop — --match and --attendee filter as they page, so --limit counts matches, not records fetched

03

--dedupe collapses duplicate records — the same call recorded by two colleagues otherwise inflates every count

04

Action items as records — one per commitment, stamped with its meeting and a playback URL that jumps to the moment it was said

05

Transcripts stream one record per utterance — filter by speaker and pipe, or --markdown for a readable block

06

Rate-limit aware — content reads land in Fathom's heavy 30/min bucket, so --with is off by default and warns when you opt in

07

Signed media URLs are credentials — redacted by default; download fetch saves the bytes without ever printing the link

08

Local webhook signature verification — check a captured payload without pasting the secret into a throwaway script

09

Native OS dialog for secret entry — auth add --form takes the key from keyboard to keychain, never through a model's context

10

MCP server with readOnlyHint annotations — auth, config and webhooks deliberately not exposed

Install

Homebrew

>_
$ brew install shhac/tap/agent-fathom

AI Agent Skill

>_
$ npx skills add shhac/agent-skills --skill agent-fathom --global

GitHub Release (macOS)

>_
$ curl -L https://github.com/shhac/agent-fathom/releases/latest/download/agent-fathom-darwin-arm64.tar.gz | tar xz

Go Install

>_
$ go install github.com/shhac/agent-fathom/cmd/agent-fathom@latest

Build from Source

>_
$ git clone https://github.com/shhac/agent-fathom.git && cd agent-fathom && make build

Getting Started

Fathom API keys are user-scoped, not org-scoped — a key only reaches meetings its owner recorded or was shared, so two keys from the same company see different data. Generate one at fathom.video/customize#api-access-header and label the profile with whose view it is.

01 · Add your key through a native OS dialog

>_
$ agent-fathom auth add work --form --label "Your view (CS team)"

--form collects the API key through an OS dialog, so it goes straight from your keyboard into the keychain — never into a chat transcript. --api-key exists for automation.

02 · Confirm the credential and its mode

>_
$ agent-fathom auth check

Reports whether an API key or an OAuth access token is in use. Fathom ignores include_summary/include_transcript for OAuth apps, so --with is refused under a token.

03 · Ask the map before the API

>_
$ agent-fathom usage

Prints the whole command surface organized by question — the right first call for an agent.

04 · List wide, fetch narrow

>_
$ agent-fathom meetings list --domain acme.com --dedupe

Content reads sit in a heavy bucket that drops to 5/min under load, so list without --with, pick the meetings that matter, then fetch those transcripts individually.

Usage

>_ What happened recently
$ agent-fathom meetings list --since 2026-07-01T00:00:00Z
>_ What we discussed with a company
$ agent-fathom meetings list --domain acme.com --with summary
>_ Title search, matched loosely
$ agent-fathom meetings list --match 'produc.*(collab|colab)'
>_ Everything still outstanding
$ agent-fathom action-items --open
>_ Commitments nobody picked up
$ agent-fathom action-items --unassigned --open
>_ What one person said, verbatim
$ agent-fathom recordings transcript 123456789 --speaker "Jane"
>_ Save a recording without printing its signed URL
$ agent-fathom recordings download fetch 123456789 dl_abc123