pp-fathom

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/fathom/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Fathom — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `fathom-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install fathom --cli-only
   ```
2. Verify: `fathom-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/productivity/fathom/cmd/fathom-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## When to Use This CLI

Use fathom-pp-cli when you need cross-meeting intelligence that the Fathom web UI and MCP servers cannot provide: commiment audits across all calls, topic trend analysis over weeks or months, pre-call account briefs, or pipeline cadence monitoring. Run sync once per day to keep the local store current, then all analysis commands run offline. Not a substitute for the Fathom web UI for reviewing individual recordings or managing your account.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Local state that compounds
- **`commitments`** — See every open action item you promised across all calls — grouped by meeting, assignee, and date — without opening a single recording.

  _Use when you need a weekly accountability audit of all meeting commitments before a 1:1 or team sync._

  ```bash
  fathom-pp-cli commitments --assignee me --since 30d --agent
  ```
- **`topics`** — Find out how often 'pricing,' 'onboarding,' or any keyword has surfaced in your meetings over the past N weeks — with week-over-week trend.

  _Use before a board meeting or quarterly review to synthesize what themes have been dominating customer calls._

  ```bash
  fathom-pp-cli topics --terms pricing,onboarding --weeks 12 --agent
  ```
- **`velocity`** — Track whether your meeting cadence with a key account is accelerating, stable, or stalling — month by month.

  _Use for pipeline health reviews: a stalling cadence with a key account is an early warning signal before the deal goes cold._

  ```bash
  fathom-pp-cli velocity --domain stripe.com --months 6 --agent
  ```
- **`workload`** — See which team members are spending the most hours in meetings per week and whether the load is worsening.

  _Use in 1:1 prep or team planning to identify who is in 'meeting hell' before assigning more collaborative work._

  ```bash
  fathom-pp-cli workload --team Engineering --weeks 4 --threshold 15 --agent
  ```

### Agent-native plumbing
- **`brief`** — Get a chronological history of every meeting with a specific person or company — past topics, open action items, last contact date — before you join a call.

  _Use immediately before a customer call to surface prior commitments and context without opening multiple browser tabs._

  ```bash
  fathom-pp-cli brief --domain acme.com --agent
  ```
- **`account`** — View a complete, domain-keyed history with any company: every meeting, topics discussed, action items, and cadence — in one structured output.

  _Use during account reviews, renewal prep, or CRM updates to get a full picture of all interactions with a company._

  ```bash
  fathom-pp-cli account --domain notion.so --agent
  ```

### Operational tooling
- **`stale`** — Find recordings that were captured but have no transcript, summary, or action items synced — useful for operators debugging pipeline gaps.

  _Use on Monday morning to audit which recordings from last week are missing data before your team needs them._

  ```bash
  fathom-pp-cli stale --since 7d --agent
  ```
- **`crm-gaps`** — Surface CRM-matched meetings where no action items were logged — calls that touched active deals but left no paper trail.

  _Use in RevOps audits to find sales calls where reps talked to prospects but forgot to log next steps in the CRM._

  ```bash
  fathom-pp-cli crm-gaps --since 30d --agent
  ```
- **`coverage`** — Track how reliably a recurring meeting (weekly planning, standup, 1:1) is being recorded over time.

  _Use to verify that mandatory-record meetings are actually being captured before auditing team performance._

  ```bash
  fathom-pp-cli coverage --pattern 'Weekly Planning' --weeks 10 --agent
  ```

## Command Reference

**meetings** — Meeting recordings with transcripts, summaries, and action items

- `fathom-pp-cli meetings` — List meetings with optional filters and included data

**recordings** — Individual recording data: transcripts and summaries

- `fathom-pp-cli recordings get-summary` — Get AI-generated meeting summary in markdown format
- `fathom-pp-cli recordings get-transcript` — Get full transcript for a recording with speaker attribution and timestamps

**team-members** — Members of your teams

- `fathom-pp-cli team-members` — List team members, optionally filtered by team name

**teams** — Teams your account has access to

- `fathom-pp-cli teams` — List all teams accessible to your account

**webhooks** — Webhooks for async meeting completion notifications

- `fathom-pp-cli webhooks create` — Create a webhook to receive meeting data on completion
- `fathom-pp-cli webhooks delete` — Delete a webhook by ID


### Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

```bash
fathom-pp-cli which "<capability in your own words>"
```

`which` resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code `0` means at least one match; exit code `2` means no confident match — fall back to `--help` or use a narrower query.

## Recipes

### Export local store for use on another machine

```bash
# Export all synced meetings to JSONL (one record per line)
fathom-pp-cli db export --format jsonl --output ~/fathom-backup.jsonl

# Export as SQLite file
fathom-pp-cli db export --format sqlite --output ~/fathom-backup.db

# Restore on another machine (no API calls, no re-sync needed)
fathom-pp-cli db restore --format jsonl --input ~/fathom-backup.jsonl
fathom-pp-cli db restore --format sqlite --input ~/fathom-backup.db
```

Pure local operation — reads from SQLite, writes to file. Run `sync --full` once, then export and share. On the new machine: install `fathom-pp-cli`, set `FATHOM_PP_CLI_API_KEY`, restore from the file, and all commands work offline immediately.

### Find a meeting by topic or keyword

```bash
fathom-pp-cli search "data pipeline clearpack" --limit 5
fathom-pp-cli search "joey action items" --json --select title,date,url,snippet
```

Full-text search across all synced transcripts, summaries, action items, and titles. Returns ranked results with highlighted snippet showing where the term matched. Searches offline — no API quota. Run `sync --full` first.

### Pre-call brief for a customer

```bash
fathom-pp-cli brief --domain acme.com --agent --select meetings.title,meetings.date,open_action_items
```

Pull all history with Acme before joining a call — past topics, open commitments, last meeting date.

### Weekly commitment audit

```bash
fathom-pp-cli commitments --since 7d --agent --select meet