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. 表示されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $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 のウェブ UI や MCP サーバーでは提供できない、複数のミーティングにまたがる分析が必要な場合に fathom-pp-cli を使用します。たとえば、すべての通話におけるコミットメントの監査、数週間から数か月にわたるトピックのトレンド分析、通話前のアカウント概要の作成、パイプラインの頻度の監視などです。ローカルストアを最新の状態に保つため、1 日 1 回同期してください。その後の分析コマンドはすべてオフラインで実行されます。個々の録画を確認したり、アカウントを管理したりする場合は、Fathom のウェブ UI を使用してください。この CLI はその代替ではありません。

独自の機能

これらの機能は、この 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
  

エージェント向けの機能

• 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 は少なくとも 1 件の候補があることを示し、終了コード 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

エンジニアのうち、週に 15 時間を超えて会議に費やしている人と、その状況が悪化しているかどうかを確認できます。

認証の設定

Fathom は、X-Api-Key ヘッダーを介して渡される API キーを使用します。fathom.video → User Settings → API Access でキーを生成してください。環境変数に FATHOM_PP_CLI_API_KEY を設定してから、doctor を実行して確認します。

fathom-pp-cli doctor を実行して設定を確認します。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout に JSON、stderr にエラーを出力します

• フィルター可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストした構造をたどり、配列では各要素を順にたどります。冗長な API でコンテキストを小さく保つために重要です。

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

• プレビュー可能 — --dry-run で、送信せずにリクエストを表示します

• オフラインに対応 — sync/search コマンドは、利用可能な場合、ローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示せず、すべての入力をフラグで指定します

• 明示的な再試行 — すでに存在する作成対象を成功として扱う場合にのみ --idempotent を使用し、削除対象が存在しない場合に成功として扱う場合にのみ --ignore-missing を使用してください

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力をプロベナンスエンベロープでラップします。

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

データには .results を、ライブデータかローカルデータかの判別には .meta.source を解析してください。人が読みやすい N results (live) という概要が stderr に出力されるのは、stdout がターミナルの場合のみです。パイプやエージェントのコンシューマーには、stdout に純粋な JSON が出力されます。

エージェントからのフィードバック

この 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 されることはありません。デフォルトの動作はローカルのみです。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で記録します。積み重ねることで価値が生まれるのは、そうした内容です。

出力の送信先

すべてのコマンドで --deliver <sink> を指定できます。出力は stdout に加えて（または stdout の代わりに）指定した送信先に送られるため、エージェントはコマンド結果を手動でパイプ処理せずに振り分けられます。対応している送信先は 3 種類です。

送信先	動作
stdout	デフォルト。stdout のみへ出力
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、対応しているスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを stderr に記録します。

名前付きプロファイル

プロファイルは、保存したフラグ値のセットで、複数回の実行で再利用できます。スケジュールされたエージェントが毎回同じ設定で同じコマンドを呼び出す場合に使用してください。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 に一覧表示するため、内容を確認するエージェントは実行時にそれらを検出できます。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が不正）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中です（待機してから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → fathom-pp-cli --help の出力を表示
2. install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の「前提条件」を参照
3. その他すべて → 直接使用（--agent を付けて CLI コマンドを実行）

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