pp-fathom

Fathom — Printing Press CLI

前置条件：安装 CLI

此技能使用 fathom-pp-cli 二进制文件。**调用此技能中的任何命令之前，必须确认 CLI 已安装。**如果尚未安装，请先安装：

1. 使用 Printing Press 安装程序安装。在 macOS/Linux 上，二进制文件默认安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

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

2. 验证：fathom-pp-cli --version
3. 确保报告的安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败（没有 Node、处于离线状态等），请改用直接 Go 安装（需要 Go 1.26.6 或更高版本）：

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

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。验证成功前，请勿执行技能命令。

何时使用此 CLI

当你需要 Fathom 网页界面和 MCP 服务无法提供的跨会议分析能力时，请使用 fathom-pp-cli：例如审计所有通话中的承诺、分析数周或数月的主题趋势、准备通话前的客户简报，或监控销售管道节奏。每天运行一次 sync 以更新本地存储，然后所有分析命令都可离线运行。它不能替代 Fathom 网页界面来查看单个录音或管理账户。

独特功能

此 API 的其他工具均不提供以下功能。

会持续积累的本地状态

• commitments — 查看你在所有通话中承诺的每一项待办事项，按会议、负责人和日期分组，无需打开任何录音。

  当你需要在 1:1 或团队同步会议前，对所有会议承诺进行每周责任审查时使用。

  fathom-pp-cli commitments --assignee me --since 30d --agent
  

• topics — 查看过去 N 周的会议中，“pricing”、“onboarding”或任何关键词出现的频率，以及逐周趋势。

  在董事会会议或季度回顾前使用，以总结客户通话中占主导地位的主题。

  fathom-pp-cli topics --terms pricing,onboarding --weeks 12 --agent
  

• velocity — 按月追踪你与重要客户的会议频率是在上升、持平还是下降。

  用于销售管道健康度审查：与重要客户的会议频率下降，是交易逐渐失去进展的早期预警信号。

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

• workload — 查看哪些团队成员每周花在会议上的时间最多，以及工作负荷是否在加重。

  用于准备 1:1 或团队规划，提前发现谁正陷入“会议地狱”，以免再给他们安排更多协作工作。

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

面向 Agent 的基础功能

• brief — 在加入通话前，获取与特定人员或公司的所有会议按时间排列的历史记录，包括过去讨论的主题、待办事项和最近联系日期。

  在客户通话前立即使用，无需打开多个浏览器标签页，即可了解之前的承诺和背景信息。

  fathom-pp-cli brief --domain acme.com --agent
  

• account — 以域名为键，查看与任意公司的完整历史记录：所有会议、讨论过的主题、待办事项和会议频率，集中在一个结构化输出中。

  在账户审查、续约准备或 CRM 更新期间使用，以全面了解与公司的所有互动。

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

运维工具

• stale — 查找已录制但尚未同步转录文本、摘要或待办事项的录音；对于排查管道缺口的运维人员很有用。

  在周一早上使用，审查上周哪些录音缺少数据，以便团队需要时能够及时补齐。

  fathom-pp-cli stale --since 7d --agent
  

• crm-gaps — 找出与 CRM 匹配但没有记录待办事项的会议，即涉及活跃交易却没有留下记录的通话。

  在 RevOps 审计中使用，找出销售代表与潜在客户交谈后，却忘记在 CRM 中记录后续步骤的销售通话。

  fathom-pp-cli crm-gaps --since 30d --agent
  

• coverage — 追踪周期性会议（每周规划、站会、1:1）随时间推移被录制的可靠程度。

  用于在审计团队绩效前，确认必须录制的会议确实都已录制。

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

命令参考

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

查找合适的命令

知道要做什么，但不确定该用哪个命令时，可以直接向 CLI 提问：

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

which 会根据自然语言功能查询，从此 CLI 精选的功能索引中找出最匹配的命令。退出代码 0 表示至少有一个匹配项；退出代码 2 表示没有可靠的匹配项——请改用 --help 或使用更具体的查询。

操作示例

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

# 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

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

按主题或关键词查找会议

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。

客户会前简报

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

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

每周承诺审核

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

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

为董事会准备主题趋势

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

展示过去一个季度所有客户通话中关键主题的每周频率变化。

销售管道进展检查

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

查看与 Acme 的会议频率是在增加、持平还是停滞——及早预警可能失去热度的交易。

团队会议负荷审核

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

找出哪些工程师每周参加会议超过 15h，以及这种情况是否正在加剧。

身份验证设置

Fathom 使用通过 X-Api-Key 标头传递的 API 密钥。前往 fathom.video → User Settings → API Access 生成密钥。在环境中设置 FATHOM_PP_CLI_API_KEY，然后运行 doctor 进行验证。

运行 fathom-pp-cli doctor 验证设置。

Agent 模式

在任意命令后添加 --agent。它会扩展为：--json --compact --no-input --no-color --yes。

• 可通过管道传输 — JSON 输出到 stdout，错误输出到 stderr

• 可筛选 — --select 保留部分字段。点分路径可深入嵌套结构；数组会逐项遍历。在输出冗长的 API 中，这对控制上下文大小至关重要：

  fathom-pp-cli meetings --agent --select id,name,status
  

• 可预览 — --dry-run 显示请求，但不会发送

• 适合离线使用 — 有本地 SQLite 存储时，sync/search 命令可使用该存储

• 非交互式 — 从不提示输入；所有输入都通过标志指定

• 明确重试行为 — 仅当已存在的创建操作应视为成功时才使用 --idempotent；仅当目标不存在的删除操作应视为成功时才使用 --ignore-missing

响应封装

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

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

解析 .results 获取数据，并查看 .meta.source 确认数据来自实时来源还是本地来源。仅当 stdout 是终端时，才会向 stderr 打印易读的 N results (live) 摘要；通过管道传递的命令或 Agent 消费者在 stdout 上只会收到纯 JSON。

Agent 反馈

当你（或 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 发送。默认行为仅保存到本地。

请写下让你感到意外的地方，而不是提交错误报告。简短、具体、一行即可：这才是会不断积累的部分。

输出传递

每条命令都接受 --deliver <sink>。输出会发送到指定的 sink，并且可以同时输出到 stdout，也可以替代 stdout，这样 Agent 无需手动通过管道传递结果即可路由命令输出。支持三种 sink：

Sink	效果
stdout	默认；仅写入 stdout
file:<path>	将输出原子性地写入 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到该 URL（传入 --compact 时使用 application/json 或 application/x-ndjson）

不支持的方案会被拒绝，并返回包含受支持方案列表的结构化错误。Webhook 失败时会返回非零退出码，并在 stderr 中记录 URL 和 HTTP 状态。

命名配置

配置是一组已保存的标志值，可在多次调用中重复使用。当计划任务中的 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 在运行时发现。

退出代码

代码	含义
0	成功
2	用法错误（参数错误）
3	未找到资源
4	需要身份验证
5	API 错误（上游问题）
7	触发速率限制（等待后重试）
10	配置错误

参数解析

解析 $ARGUMENTS：

1. 为空、help 或 --help → 显示 fathom-pp-cli --help 输出
2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上文的先决条件
3. 其他任何内容 → 直接使用（作为 CLI 命令执行，并附带 --agent）

MCP 服务安装

1. 安装 MCP 服务：

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

2. 在 Claude Code 中注册：

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

3. 验证：claude mcp list

直接使用

1. 检查是否已安装：which fathom-pp-cli 如果未找到，请提供安装选项（参见本技能开头的先决条件）。
2. 根据用户的查询，从上文的独特功能和命令参考中选择最合适的命令。
3. 使用 --agent 标志执行：

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

4. 如果有歧义，请查看子命令帮助：fathom-pp-cli <command> --help。