pp-fathom

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Fathom — Printing Press CLI

Prerequisites: Install the CLI

前置条件：安装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:

Install via the Printing Press installer:

bash

npx -y @mvanhorn/printing-press install fathom --cli-only

Verify:
```
fathom-pp-cli --version
```
Ensure
```
$GOPATH/bin
```
(or
```
$HOME/go/bin
```
) is on
```
$PATH
```
.

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

--version

reports "command not found" after install, the install step did not put the binary on

$PATH

. Do not proceed with skill commands until verification succeeds.

fathom-pp-cli pulls every meeting, transcript, summary, and action item into a local SQLite store, then unlocks cross-meeting intelligence no MCP server or web UI can provide: commitment tracking across all your calls, topic trend analysis over weeks, pre-call account briefs, pipeline velocity detection, and team meeting-load audits.

本技能驱动

fathom-pp-cli

二进制文件。在调用本技能的任何命令之前，你必须确认CLI已安装。如果未安装，请先执行以下步骤：

通过Printing Press安装器安装：

bash

npx -y @mvanhorn/printing-press install fathom --cli-only

验证安装：
```
fathom-pp-cli --version
```
确保
```
$GOPATH/bin
```
（或
```
$HOME/go/bin
```
）已添加到
```
$PATH
```
环境变量中。

如果

npx

安装失败（无Node环境、离线等情况），可改用直接Go安装方式（需要Go 1.26.3或更高版本）：

bash

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

如果安装后执行

--version

提示「command not found」，说明安装步骤未将二进制文件添加到

$PATH

中。在验证成功前，请不要继续执行技能命令。

fathom-pp-cli会将所有会议、转录文本、摘要和行动项拉取到本地SQLite存储中，进而解锁MCP服务器或Web UI无法提供的跨会议智能功能：跨所有通话的承诺跟踪、数周内的主题趋势分析、会前客户账户简报、销售管道速度检测以及团队会议负载审计。

When to Use This CLI

何时使用此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.

当你需要Fathom Web UI和MCP服务器无法提供的跨会议智能功能时，使用fathom-pp-cli：跨所有通话的承诺审计、数周或数月内的主题趋势分析、会前客户账户简报，或销售管道节奏监控。每天运行一次同步以保持本地存储最新，之后所有分析命令均可离线运行。本工具不能替代Fathom Web UI用于查看单个录制内容或管理账户。

Unique Capabilities

独特功能

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

这些功能是其他同类型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
```

commitments
— 查看你在所有通话中承诺的所有未完成行动项，按会议、负责人和日期分组，无需打开任何录制内容。
适用于在一对一会议或团队同步前，对所有会议承诺进行每周问责审计。
bash
```
fathom-pp-cli commitments --assignee me --since 30d --agent
```
topics
— 查看「定价」「入职培训」或任何关键词在过去N周的会议中出现的频率，以及周环比趋势。
适用于董事会会议或季度评审前，梳理客户通话中的主导主题。
bash
```
fathom-pp-cli topics --terms pricing,onboarding --weeks 12 --agent
```
velocity
— 逐月跟踪你与关键客户的会议节奏是加快、稳定还是停滞。
适用于销售管道健康评审：与关键客户的会议节奏停滞是交易变冷的早期预警信号。
bash
```
fathom-pp-cli velocity --domain stripe.com --months 6 --agent
```
workload
— 查看哪些团队成员每周花在会议上的时间最多，以及负载是否在增加。
适用于一对一会议准备或团队规划，在分配更多协作工作前识别谁陷入了「会议地狱」。
bash
```
fathom-pp-cli workload --team Engineering --weeks 4 --threshold 15 --agent
```

Agent-native plumbing

Agent原生适配

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
```

brief
— 在加入通话前，获取与特定人员或公司的所有会议时间线历史记录：过往主题、未完成行动项、上次联系日期。
适用于客户通话前立即获取先前承诺和上下文信息，无需打开多个浏览器标签页。
bash
```
fathom-pp-cli brief --domain acme.com --agent
```
account
— 查看与任何公司的完整域名关联历史记录：所有会议、讨论主题、行动项和会议节奏，以结构化输出呈现。
适用于账户评审、续约准备或CRM更新，获取与公司的所有交互全貌。
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
```

stale
— 查找已录制但未同步转录文本、摘要或行动项的内容，对排查管道缺口的运维人员很有用。
适用于周一早上审计上周哪些录制内容缺少数据，以免影响团队使用。
bash
```
fathom-pp-cli stale --since 7d --agent
```
crm-gaps
— 识别已匹配CRM但未记录行动项的会议：涉及有效交易但未留下纸质记录的通话。
适用于营收运维审计，找出销售代表与潜在客户通话但忘记在CRM中记录后续步骤的情况。
bash
```
fathom-pp-cli crm-gaps --since 30d --agent
```
coverage
— 跟踪定期会议（每周规划、站会、一对一会议）的录制可靠性随时间的变化。
适用于在审计团队绩效前，验证强制录制的会议是否确实被捕获。
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

meetings — 包含转录文本、摘要和行动项的会议录制内容

```
fathom-pp-cli meetings
```
— 列出会议，可使用可选过滤器和包含数据参数

recordings — 单个录制内容数据：转录文本和摘要

```
fathom-pp-cli recordings get-summary
```
— 获取AI生成的Markdown格式会议摘要
```
fathom-pp-cli recordings get-transcript
```
— 获取带发言者归属和时间戳的完整录制内容转录文本

team-members — 你的团队成员

```
fathom-pp-cli team-members
```
— 列出团队成员，可按团队名称筛选

teams — 你的账户可访问的团队

```
fathom-pp-cli teams
```
— 列出你的账户可访问的所有团队

webhooks — 用于异步会议完成通知的Webhook

```
fathom-pp-cli webhooks create
```
— 创建Webhook以在会议完成时接收数据
```
fathom-pp-cli webhooks delete
```
— 通过ID删除Webhook

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

means at least one match; exit code

means no confident match — fall back to

--help

or use a narrower query.

当你知道要做什么但不知道对应命令时，可直接询问CLI：

bash

fathom-pp-cli which "<用你自己的话描述功能>"

which

会将自然语言功能查询解析为该CLI精选功能索引中最匹配的命令。退出码

表示至少找到一个匹配项；退出码

表示没有确定的匹配项——请改用

--help

或缩小查询范围。

Recipes

使用示例

Export local store for use on another machine

导出本地存储以在另一台机器上使用

bash

undefined

bash

undefined

Export all synced meetings to JSONL (one record per line)

将所有同步的会议导出为JSONL格式（每行一条记录）

fathom-pp-cli db export --format jsonl --output ~/fathom-backup.jsonl

Export as SQLite file

导出为SQLite文件

fathom-pp-cli db export --format sqlite --output ~/fathom-backup.db

Restore on another machine (no API calls, no re-sync needed)

在另一台机器上恢复（无需调用API，无需重新同步）

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.

fathom-pp-cli db restore --format jsonl --input ~/fathom-backup.jsonl fathom-pp-cli db restore --format sqlite --input ~/fathom-backup.db


纯本地操作——从SQLite读取，写入文件。运行一次`sync --full`后即可导出并共享。在新机器上：安装`fathom-pp-cli`，设置`FATHOM_PP_CLI_API_KEY`，从文件恢复，所有命令即可立即离线运行。

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.

bash

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

对所有同步的转录文本、摘要、行动项和标题进行全文搜索。返回带高亮匹配片段的排序结果。搜索离线进行——不消耗API配额。请先运行

sync --full

。

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.

bash

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

在加入与Acme的通话前，拉取所有历史记录——过往主题、未完成承诺、上次会议日期。

Weekly commitment audit

每周承诺审计

bash

fathom-pp-cli commitments --since 7d --agent --select meeting_title,description,assignee.name,completed

Surface every action item from last week's calls, grouped by meeting — know what's still open before Monday standup.

bash

fathom-pp-cli commitments --since 7d --agent --select meeting_title,description,assignee.name,completed

显示上周所有通话中的行动项，按会议分组——在周一站会前了解哪些仍未完成。

Topic trend for board prep

董事会准备的主题趋势

bash

fathom-pp-cli topics --terms 'pricing,churn,roadmap' --weeks 12 --agent

Show week-over-week frequency of key themes across all customer calls for the past quarter.

bash

fathom-pp-cli topics --terms 'pricing,churn,roadmap' --weeks 12 --agent

显示过去一个季度所有客户通话中关键主题的周环比出现频率。

Pipeline velocity check

销售管道速度检查

bash

fathom-pp-cli velocity --domain acme.com --months 6 --agent

See whether your meeting cadence with Acme has been increasing, flat, or stalling — early warning for deals going cold.

bash

fathom-pp-cli velocity --domain acme.com --months 6 --agent

查看与Acme的会议节奏是加快、持平还是停滞——交易变冷的早期预警。

Team meeting load audit

团队会议负载审计

bash

fathom-pp-cli workload --team Engineering --weeks 4 --threshold 15 --agent --select name,weekly_hours,trend

Find which engineers are spending over 15h/week in meetings and whether it's getting worse.

bash

fathom-pp-cli workload --team Engineering --weeks 4 --threshold 15 --agent --select name,weekly_hours,trend

找出每周花在会议上的时间超过15小时的工程师，以及负载是否在增加。

Auth Setup

认证设置

Fathom uses an API key passed via the X-Api-Key header. Generate one at fathom.video → User Settings → API Access. Set FATHOM_PP_CLI_API_KEY in your environment, then run doctor to verify.

Run

fathom-pp-cli doctor

to verify setup.

Fathom使用通过X-Api-Key头传递的API密钥。请在fathom.video → 用户设置 → API访问中生成密钥。在环境变量中设置

FATHOM_PP_CLI_API_KEY

，然后运行doctor命令验证设置。

运行

fathom-pp-cli doctor

验证设置是否正确。

Agent Mode

Agent模式

Add

--agent

to any command. Expands to:

--json --compact --no-input --no-color --yes

Pipeable — JSON on stdout, errors on stderr
Filterable —
```
--select
```
keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
bash
```
fathom-pp-cli meetings --agent --select id,name,status
```
Previewable —
```
--dry-run
```
shows the request without sending
Offline-friendly — sync/search commands can use the local SQLite store when available
Non-interactive — never prompts, every input is a flag
Explicit retries — use
```
--idempotent
```
only when an already-existing create should count as success, and
```
--ignore-missing
```
only when a missing delete target should count as success

在任何命令后添加

--agent

参数。等效于：

--json --compact --no-input --no-color --yes

。

可管道化 — 标准输出为JSON，错误信息输出到标准错误
可过滤 —
```
--select
```
参数保留字段子集。点路径可深入嵌套结构；数组可遍历元素。对于冗长的API，这是保持上下文精简的关键：
bash
```
fathom-pp-cli meetings --agent --select id,name,status
```
可预览 —
```
--dry-run
```
参数显示请求但不发送
离线友好 — 同步/搜索命令在本地SQLite存储可用时可使用该存储
非交互式 — 从不提示，所有输入均通过标志参数提供
显式重试 — 仅当已存在的创建操作应被视为成功时使用
```
--idempotent
```
，仅当缺失的删除目标应被视为成功时使用
```
--ignore-missing
```

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse

.results

for data and

.meta.source

to know whether it's live or local. A human-readable

N results (live)

summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

从本地存储或API读取数据的命令会将输出包装在溯源信封中：

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

解析

.results

获取数据，

.meta.source

可了解数据是实时的还是本地的。仅当标准输出为终端时，才会将人类可读的

N results (live)

摘要打印到标准错误；管道/Agent消费者仅会在标准输出获取纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:

fathom-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
fathom-pp-cli feedback --stdin < notes.txt
fathom-pp-cli feedback list --json --limit 10

Entries are stored locally at

~/.fathom-pp-cli/feedback.jsonl

. They are never POSTed unless

FATHOM_FEEDBACK_ENDPOINT

is set AND either

--send

is passed or

FATHOM_FEEDBACK_AUTO_SEND=true

. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

当你（或Agent）发现此CLI存在问题时，请记录：

fathom-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
fathom-pp-cli feedback --stdin < notes.txt
fathom-pp-cli feedback list --json --limit 10

反馈条目存储在本地

~/.fathom-pp-cli/feedback.jsonl

文件中。除非设置了

FATHOM_FEEDBACK_ENDPOINT

且传递了

--send

参数或设置了

FATHOM_FEEDBACK_AUTO_SEND=true

，否则反馈条目绝不会被POST发送。默认行为是仅本地存储。

请记录让你感到意外的内容，而非提交bug报告。简短、具体、一句话即可：这样的内容才会累积价值。

Output Delivery

输出交付

Every command accepts

--deliver <sink>

. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
`stdout`	Default; write to stdout only
`file:<path>`	Atomically write output to `<path>` (tmp + rename)
`webhook:<url>`	POST the output body to the URL ( `application/json` or `application/x-ndjson` when `--compact` )

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

每个命令都接受

--deliver <sink>

参数。输出会发送到指定的接收器，同时（或代替）输出到标准输出，以便Agent无需手动管道即可路由命令结果。支持三种接收器：

接收器	效果
`stdout`	默认；仅输出到标准输出
`file:<path>`	原子性地将输出写入 `<path>` （先写入临时文件再重命名）
`webhook:<url>`	将输出体POST到指定URL（当使用 `--compact` 时为 `application/json` 或 `application/x-ndjson` 格式）

未知的协议会被拒绝，并返回结构化错误信息，列出支持的协议。Webhook失败会返回非零退出码，并在标准错误中记录URL和HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

fathom-pp-cli profile save briefing --json
fathom-pp-cli --profile briefing meetings
fathom-pp-cli profile list --json
fathom-pp-cli profile show briefing
fathom-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults.

agent-context

lists all available profiles under

available_profiles

so introspecting agents discover them at runtime.

配置文件是一组保存的标志值，可在多次调用中重复使用。适用于调度Agent每次运行相同命令且配置相同的场景——即HeyGen的「Beacon」模式。

fathom-pp-cli profile save briefing --json
fathom-pp-cli --profile briefing meetings
fathom-pp-cli profile list --json
fathom-pp-cli profile show briefing
fathom-pp-cli profile delete briefing --yes

显式标志始终优先于配置文件值；配置文件值优先于默认值。

agent-context

会在

available_profiles

下列出所有可用配置文件，以便内省Agent在运行时发现它们。

Exit Codes

退出码

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
4	Authentication required
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

代码	含义
0	成功
2	使用错误（参数错误）
3	资源未找到
4	需要认证
5	API错误（上游问题）
7	速率限制（请等待并重试）
10	配置错误

Argument Parsing

参数解析

Parse

$ARGUMENTS

Empty,
help
, or
--help
→ show
```
fathom-pp-cli --help
```
output
Starts with
install
→ ends with
```
mcp
```
→ MCP installation; otherwise → see Prerequisites above
Anything else → Direct Use (execute as CLI command with
```
--agent
```
)

解析

$ARGUMENTS

：

为空、
help
或
--help
→ 显示
```
fathom-pp-cli --help
```
输出
以
install
开头 → 以
```
mcp
```
结尾 → MCP安装；否则 → 请参阅上方的前置条件
其他情况 → 直接使用（带
```
--agent
```
标志执行CLI命令）

MCP Server Installation

MCP服务器安装

Install the MCP server:

bash

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

bash

claude mcp add fathom-pp-mcp -- fathom-pp-mcp

Verify:
```
claude mcp list
```

安装MCP服务器：

bash

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

在Claude Code中注册：

bash

claude mcp add fathom-pp-mcp -- fathom-pp-mcp

验证：
```
claude mcp list
```

Direct Use

直接使用

Check if installed:
```
which fathom-pp-cli
```
If not found, offer to install (see Prerequisites at the top of this skill).
Match the user query to the best command from the Unique Capabilities and Command Reference above.

Execute with the

--agent

flag:

bash

fathom-pp-cli <command> [subcommand] [args] --agent

If ambiguous, drill into subcommand help:
```
fathom-pp-cli <command> --help
```
.

检查是否安装：
```
which fathom-pp-cli
```
如果未找到，提供安装选项（请参阅顶部的前置条件）。
将用户查询与上方「独特功能」和「命令参考」中的最佳命令匹配。

带

--agent

标志执行：

bash

fathom-pp-cli <command> [subcommand] [args] --agent

如果存在歧义，查看子命令帮助：
```
fathom-pp-cli <command> --help
```
。