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
Question-shaped commands — list by date, company domain, attendee, recorder, team or meeting type rather than by endpoint
Client-side search inside the paging loop — --match and --attendee filter as they page, so --limit counts matches, not records fetched
--dedupe collapses duplicate records — the same call recorded by two colleagues otherwise inflates every count
Action items as records — one per commitment, stamped with its meeting and a playback URL that jumps to the moment it was said
Transcripts stream one record per utterance — filter by speaker and pipe, or --markdown for a readable block
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
Signed media URLs are credentials — redacted by default; download fetch saves the bytes without ever printing the link
Local webhook signature verification — check a captured payload without pasting the secret into a throwaway script
Native OS dialog for secret entry — auth add --form takes the key from keyboard to keychain, never through a model's context
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
$ agent-fathom meetings list --since 2026-07-01T00:00:00Z $ agent-fathom meetings list --domain acme.com --with summary $ agent-fathom meetings list --match 'produc.*(collab|colab)' $ agent-fathom action-items --open $ agent-fathom action-items --unassigned --open $ agent-fathom recordings transcript 123456789 --speaker "Jane" $ agent-fathom recordings download fetch 123456789 dl_abc123