pp-fireflies
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseFireflies.ai — Printing Press CLI
Fireflies.ai — Printing Press CLI
Prerequisites: Install the CLI
前提条件:安装CLI
This skill drives the binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
fireflies-pp-cli- Install via the Printing Press installer:
bash
npx -y @mvanhorn/printing-press install fireflies --cli-only - Verify:
fireflies-pp-cli --version - Ensure (or
$GOPATH/bin) is on$HOME/go/bin.$PATH
If the install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):
npxbash
go install github.com/mvanhorn/printing-press-library/library/productivity/fireflies/cmd/fireflies-pp-cli@latestIf reports "command not found" after install, the install step did not put the binary on . Do not proceed with skill commands until verification succeeds.
--version$PATHSync your entire meeting history once, then search, analyze, and correlate across every conversation without touching the API. Find stale action items, track topic escalation over weeks, reconstruct the full history with any person or account — all offline, all composable with jq and SQL.
本技能基于二进制文件运行。在调用本技能的任何命令前,你必须确认CLI已安装。如果未安装,请先执行以下步骤:
fireflies-pp-cli- 通过Printing Press安装程序安装:
bash
npx -y @mvanhorn/printing-press install fireflies --cli-only - 验证安装:
fireflies-pp-cli --version - 确保(或
$GOPATH/bin)已添加到$HOME/go/bin环境变量中。$PATH
如果安装失败(无Node环境、离线等情况),可改用Go直接安装(要求Go 1.26.3或更高版本):
npxbash
go install github.com/mvanhorn/printing-press-library/library/productivity/fireflies/cmd/fireflies-pp-cli@latest如果安装后执行提示“command not found”,说明安装程序未将二进制文件添加到中。请在验证成功前不要执行技能相关命令。
--version$PATH只需同步一次完整的会议历史记录,之后无需调用API即可搜索、分析并关联所有对话内容。你可以查找过期的行动项、跟踪数周内的议题升级情况、重建与特定人员或客户的完整沟通历史——所有操作均可离线完成,还能与jq和SQL组合使用。
When to Use This CLI
何时使用该CLI
Use fireflies-pp-cli when you need to mine your meeting history at scale: finding dropped action items, preparing for calls with full relationship context, tracking sentiment or topic trends over weeks, or searching across thousands of meeting sentences offline. Not a substitute for the Fireflies dashboard for day-to-day recording configuration or notetaking.
当你需要大规模挖掘会议历史时,请使用fireflies-pp-cli:查找被遗漏的行动项、为通话准备完整的关系背景、跟踪数周内的情绪或议题趋势,或者离线搜索数千条会议记录。它并非Fireflies控制台的替代品,日常的录制配置或记笔记仍建议使用控制台。
Unique Capabilities
独特功能
These capabilities aren't available in any other tool for this API.
这些功能是其他基于该API的工具所不具备的。
Local state that compounds
可累积的本地状态
-
— Full-text search across all synced meeting transcripts without consuming any API quota.
transcripts searchUse to find every time a specific topic was mentioned across all meetings without burning rate-limited API calls.bashfireflies-pp-cli transcripts search "pricing objection" --agent --select id,title,dateString -
— Aggregate action items from all meetings in a date range — weekly commitment audit in one command.
action-items listUse at the end of the week to harvest all commitments made in meetings and push to a TODO file.bashfireflies-pp-cli action-items list --from 7 --agent -
— Find meetings by participant email, channel name, keyword, or date range — all client-side, no broken API date filters.
transcripts findUse when you need meetings with a specific person or channel — the API's title-based search fails when meeting names don't contain participant names.bashfireflies-pp-cli transcripts find --participant danijel.latin@verybigthings.com --from 30 --processed-only --agent -
— Show PROCESSED / PROCESSING / FAILED status for recent meetings upfront — know before you fetch.
transcripts statusUse when fetching same-day or next-morning meetings — avoids the loop of 'meeting not ready yet' failures.bashfireflies-pp-cli transcripts status --since 48h --agent -
— Most frequent topics across all meetings in a date range — what is actually consuming meeting time.
topics listUse during quarterly planning to identify recurring themes before deciding where to invest time.bashfireflies-pp-cli topics list --from 30 --top 15 --agent -
— Aggregate view of all recent meetings: titles, gists, topics, and action items in one structured output.
digestUse at session start or in a morning cron to orient on what happened yesterday before taking action.bashfireflies-pp-cli digest --since 24h --agent -
— Export a transcript as markdown to a vault directory with auto-generated YYYY-MM-DD_title.md filename.
transcripts exportUse after a client meeting to save the formatted transcript directly to the right project folder.bashfireflies-pp-cli transcripts export abc123 --vault ~/vaults/VBT/Projects/1_Active/Ryder/transcripts/ --agent
-
—— 在所有已同步的会议转录文本中进行全文搜索,无需消耗任何API配额。
transcripts search用于查找所有会议中提及特定议题的记录,无需调用受速率限制的API。bashfireflies-pp-cli transcripts search "pricing objection" --agent --select id,title,dateString -
—— 汇总指定日期范围内所有会议的行动项——只需一条命令即可完成每周承诺审核。
action-items list用于在周末收集所有会议中做出的承诺,并推送到TODO文件中。bashfireflies-pp-cli action-items list --from 7 --agent -
—— 通过参与者邮箱、频道名称、关键词或日期范围查找会议——所有操作均在客户端完成,无API日期过滤失效问题。
transcripts find用于查找与特定人员或频道相关的会议——当会议名称不包含参与者姓名时,API的基于标题的搜索会失效。bashfireflies-pp-cli transcripts find --participant danijel.latin@verybigthings.com --from 30 --processed-only --agent -
—— 直接显示近期会议的PROCESSED / PROCESSING / FAILED状态——在获取前即可了解会议处理情况。
transcripts status用于获取当日或次日的会议记录——避免出现“会议尚未准备好”的失败循环。bashfireflies-pp-cli transcripts status --since 48h --agent -
—— 显示指定日期范围内所有会议中出现频率最高的议题——了解实际占用会议时间的内容。
topics list用于季度规划时,在决定时间投入方向前识别重复出现的主题。bashfireflies-pp-cli topics list --from 30 --top 15 --agent -
—— 汇总近期所有会议的视图:在一个结构化输出中展示标题、要点、议题和行动项。
digest用于会议开始前或晨间定时任务中,在采取行动前了解昨天的会议情况。bashfireflies-pp-cli digest --since 24h --agent -
—— 将转录文本导出为markdown格式到指定目录,自动生成YYYY-MM-DD_title.md文件名。
transcripts export用于客户会议后,将格式化的转录文本直接保存到对应的项目文件夹中。bashfireflies-pp-cli transcripts export abc123 --vault ~/vaults/VBT/Projects/1_Active/Ryder/transcripts/ --agent
Person-centric intelligence
以人为中心的智能分析
-
— Chronological meeting history with a specific person — topics, action items, and talk ratio per meeting.
person timelineUse before a QBR or renewal call to reconstruct the full relationship history without reading every transcript.bashfireflies-pp-cli person timeline danijel.latin@verybigthings.com --from 90 --agent
-
—— 展示与特定人员的 chronological会议历史——包括每场会议的议题、行动项和发言占比。
person timeline用于QBR或续约通话前,无需阅读所有转录文本即可重建完整的关系历史。bashfireflies-pp-cli person timeline danijel.latin@verybigthings.com --from 90 --agent
Command Reference
命令参考
sync — Sync API data to local SQLite
- — Sync transcripts, channels, and users to local SQLite
fireflies-pp-cli sync - — Full resync from scratch
fireflies-pp-cli sync --full - — Sync specific resources
fireflies-pp-cli sync --resources transcripts,channels
transcripts — List, search, and manage meeting transcripts
- — List transcripts from local store
fireflies-pp-cli transcripts list - — Get a transcript from local store (or API with --live)
fireflies-pp-cli transcripts get <id> - — Find by participant, channel, keyword, or date
fireflies-pp-cli transcripts find - — Offline full-text search
fireflies-pp-cli transcripts search <query> - — Show recently processed transcripts
fireflies-pp-cli transcripts recent - — Show PROCESSED / PROCESSING / FAILED status
fireflies-pp-cli transcripts status - — Fetch full transcript from API and store locally
fireflies-pp-cli transcripts pull <id> - — Export as markdown to file or vault path
fireflies-pp-cli transcripts export <id> - — Update title or privacy
fireflies-pp-cli transcripts update <id> - — Share with external email addresses
fireflies-pp-cli transcripts share <id> - — Delete a transcript
fireflies-pp-cli transcripts delete <id>
summary — AI-generated meeting summary
- — Get summary (formats: overview, bullets, gist, topics, keywords, actions)
fireflies-pp-cli summary <id>
action-items — Extract action items
- — Action items from a specific transcript
fireflies-pp-cli action-items get <id> - — Aggregate action items across a date range
fireflies-pp-cli action-items list
topics — Extract and analyze topics
- — Topics from a specific transcript
fireflies-pp-cli topics get <id> - — Most frequent topics across all transcripts
fireflies-pp-cli topics list
keywords — AI-extracted keywords
- — Keywords for a transcript
fireflies-pp-cli keywords <id>
speakers — Per-speaker analytics
- — Talk time, word count, filler words, questions per speaker
fireflies-pp-cli speakers <id>
analytics — Meeting analytics
- — Team-wide analytics (requires Business+ plan)
fireflies-pp-cli analytics team - — Per-meeting speaker analytics
fireflies-pp-cli analytics meeting <id>
person — Person-centric views
- — Chronological meeting history with a person
fireflies-pp-cli person timeline <email-or-name> - — Negative-sentiment mentions across meetings
fireflies-pp-cli person complaints <email-or-name>
digest — Aggregate meeting briefing
- — Summary of all recent meetings in one view
fireflies-pp-cli digest
channels — Channel management
- — Get a single channel
fireflies-pp-cli channels <id>
users — User management
- — Get user information
fireflies-pp-cli users
sync —— 将API数据同步到本地SQLite数据库
- —— 将转录文本、频道和用户同步到本地SQLite数据库
fireflies-pp-cli sync - —— 从头开始完全重新同步
fireflies-pp-cli sync --full - —— 同步特定资源
fireflies-pp-cli sync --resources transcripts,channels
transcripts —— 列出、搜索和管理会议转录文本
- —— 列出本地存储中的转录文本
fireflies-pp-cli transcripts list - —— 从本地存储获取转录文本(添加--live可从API获取)
fireflies-pp-cli transcripts get <id> - —— 按参与者、频道、关键词或日期查找
fireflies-pp-cli transcripts find - —— 离线全文搜索
fireflies-pp-cli transcripts search <query> - —— 显示最近处理的转录文本
fireflies-pp-cli transcripts recent - —— 显示PROCESSED / PROCESSING / FAILED状态
fireflies-pp-cli transcripts status - —— 从API获取完整转录文本并存储到本地
fireflies-pp-cli transcripts pull <id> - —— 导出为markdown文件或保存到指定目录
fireflies-pp-cli transcripts export <id> - —— 更新标题或隐私设置
fireflies-pp-cli transcripts update <id> - —— 与外部邮箱地址共享
fireflies-pp-cli transcripts share <id> - —— 删除转录文本
fireflies-pp-cli transcripts delete <id>
summary —— AI生成的会议摘要
- —— 获取摘要(格式:概述、项目符号、要点、议题、关键词、行动项)
fireflies-pp-cli summary <id>
action-items —— 提取行动项
- —— 获取特定转录文本中的行动项
fireflies-pp-cli action-items get <id> - —— 汇总指定日期范围内的行动项
fireflies-pp-cli action-items list
topics —— 提取并分析议题
- —— 获取特定转录文本中的议题
fireflies-pp-cli topics get <id> - —— 显示所有转录文本中出现频率最高的议题
fireflies-pp-cli topics list
keywords —— AI提取的关键词
- —— 获取转录文本的关键词
fireflies-pp-cli keywords <id>
speakers —— 每位发言者的分析数据
- —— 每位发言者的发言时长、字数、填充词数量和提问次数
fireflies-pp-cli speakers <id>
analytics —— 会议分析
- —— 团队级分析(需要Business+套餐)
fireflies-pp-cli analytics team - —— 单场会议的发言者分析
fireflies-pp-cli analytics meeting <id>
person —— 以人为中心的视图
- —— 与特定人员的 chronological会议历史
fireflies-pp-cli person timeline <email-or-name> - —— 所有会议中提及该人员的负面情绪内容
fireflies-pp-cli person complaints <email-or-name>
digest —— 汇总会议简报
- —— 在一个视图中展示所有近期会议的摘要
fireflies-pp-cli digest
channels —— 频道管理
- —— 获取单个频道信息
fireflies-pp-cli channels <id>
users —— 用户管理
- —— 获取用户信息
fireflies-pp-cli users
Finding the right command
查找正确的命令
When you know what you want to do but not which command does it, ask the CLI directly:
bash
fireflies-pp-cli which "<capability in your own words>"which02--help当你知道要做什么但不知道对应的命令时,可直接询问CLI:
bash
fireflies-pp-cli which "<用你自己的话描述功能>"which02--helpRecipes
使用示例
Morning triage: what happened in meetings yesterday
晨间梳理:昨天的会议发生了什么
bash
fireflies-pp-cli transcripts list --from 24h --agent --select id,title,dateString,duration,summary.gistList yesterday's meetings with one-line AI summaries — no API calls if already synced.
bash
fireflies-pp-cli transcripts list --from 24h --agent --select id,title,dateString,duration,summary.gist列出昨天的会议及AI生成的一行摘要——如果已同步则无需调用API。
Find every time a client mentioned pricing
查找客户提及定价的所有记录
bash
fireflies-pp-cli search "pricing" --from 90d --agent --select id,title,speaker_name,textFull-text search across synced sentences. The --select dotted path drills into nested fields.
bash
fireflies-pp-cli search "pricing" --from 90d --agent --select id,title,speaker_name,text在已同步的文本中进行全文搜索。--select参数的点路径可深入嵌套字段。
Prepare for a QBR with account history
为QBR准备客户历史记录
bash
fireflies-pp-cli person timeline "Acme" --from 180 --agentChronological view of every meeting where 'Acme' appeared — topics, action items, talk ratios.
bash
fireflies-pp-cli person timeline "Acme" --from 180 --agent按时间顺序显示所有提及“Acme”的会议——包括议题、行动项和发言占比。
Harvest this week's action items
收集本周的行动项
bash
fireflies-pp-cli action-items list --from 7 --append ~/vaults/VBT/TODO.mdAggregate action items from all meetings in the last 7 days and append to a markdown TODO file.
bash
fireflies-pp-cli action-items list --from 7 --append ~/vaults/VBT/TODO.md汇总过去7天所有会议的行动项,并追加到markdown格式的TODO文件中。
Find what topics came up most this month
查找本月出现频率最高的议题
bash
fireflies-pp-cli topics list --from 30 --top 15 --agentMost frequent topics across all meetings in the last 30 days — what is actually consuming meeting time.
bash
fireflies-pp-cli topics list --from 30 --top 15 --agent显示过去30天所有会议中出现频率最高的议题——了解实际占用会议时间的内容。
Auth Setup
认证设置
Requires a Fireflies API key set as FIREFLIES_API_KEY. API access requires a Business plan or higher. Get your key at app.fireflies.ai → Settings → Developer.
Run to verify setup.
fireflies-pp-cli doctor需要设置FIREFLIES_API_KEY环境变量,值为Fireflies API密钥。API访问需要Business或更高套餐。可在app.fireflies.ai → 设置 → 开发者页面获取密钥。
执行验证设置是否正确。
fireflies-pp-cli doctorAgent Mode
Agent模式
Add to any command. Expands to: .
--agent--json --compact --no-input --no-color --yes-
Pipeable — JSON on stdout, errors on stderr
-
Filterable —keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
--selectbashfireflies-pp-cli transcripts list --agent --select id,title,dateString,summary.gist -
Previewable —shows the request without sending
--dry-run -
Offline-friendly — sync/search commands can use the local SQLite store when available
-
Non-interactive — never prompts, every input is a flag
-
Explicit retries — useonly when an already-existing create should count as success, and
--idempotentonly when a missing delete target should count as success--ignore-missing
在任何命令后添加参数。该参数等价于:。
--agent--json --compact --no-input --no-color --yes-
可管道传输 —— 标准输出为JSON格式,错误信息输出到标准错误
-
可过滤 ——参数保留指定字段子集。点路径可深入嵌套结构;数组可遍历元素。这对于在冗长的API响应中缩小上下文范围至关重要:
--selectbashfireflies-pp-cli transcripts list --agent --select id,title,dateString,summary.gist -
可预览 ——参数显示请求内容但不发送
--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 for data and to know whether it's live or local. A human-readable summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.
.results.meta.sourceN results (live)从本地存储或API读取数据的命令会将输出包装在来源信封中:
json
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}解析获取数据,可了解数据是实时的还是本地的。仅当标准输出为终端时,才会将人类可读的摘要输出到标准错误;管道/Agent消费者仅会在标准输出获取纯JSON内容。
.results.meta.sourceN results (live)Agent Feedback
Agent反馈
When you (or the agent) notice something off about this CLI, record it:
fireflies-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
fireflies-pp-cli feedback --stdin < notes.txt
fireflies-pp-cli feedback list --json --limit 10Entries are stored locally at . They are never POSTed unless is set AND either is passed or . Default behavior is local-only.
~/.fireflies-pp-cli/feedback.jsonlFIREFLIES_FEEDBACK_ENDPOINT--sendFIREFLIES_FEEDBACK_AUTO_SEND=trueWrite what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当你(或Agent)发现该CLI存在问题时,可记录反馈:
fireflies-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
fireflies-pp-cli feedback --stdin < notes.txt
fireflies-pp-cli feedback list --json --limit 10反馈条目存储在本地文件中。除非设置了且传递了参数或设置了,否则反馈不会被POST发送。默认行为仅存储在本地。
~/.fireflies-pp-cli/feedback.jsonlFIREFLIES_FEEDBACK_ENDPOINT--sendFIREFLIES_FEEDBACK_AUTO_SEND=true请记录让你感到意外的内容,而非提交正式的错误报告。简短、具体、一句话即可:这样的反馈才更有价值。
Output Delivery
输出交付
Every command accepts . 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:
--deliver <sink>| Sink | Effect |
|---|---|
| Default; write to stdout only |
| Atomically write output to |
| POST the output body to the URL ( |
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.
每个命令都支持参数。输出会发送到指定的接收端,同时(或替代)输出到标准输出,因此Agent无需手动管道即可路由命令结果。支持三种接收端:
--deliver <sink>| 接收端 | 效果 |
|---|---|
| 默认值;仅输出到标准输出 |
| 原子性地将输出写入 |
| 将输出主体POST到指定URL(当使用 |
不支持的协议会返回结构化错误,并列出支持的协议集合。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.
fireflies-pp-cli profile save briefing --json
fireflies-pp-cli --profile briefing transcripts list
fireflies-pp-cli profile list --json
fireflies-pp-cli profile show briefing
fireflies-pp-cli profile delete briefing --yesExplicit flags always win over profile values; profile values win over defaults. lists all available profiles under so introspecting agents discover them at runtime.
agent-contextavailable_profiles配置文件是一组保存的标志值,可在多次调用中重复使用。当定时Agent每次运行都使用相同配置调用同一命令时,可使用该功能——即HeyGen的“Beacon”模式。
fireflies-pp-cli profile save briefing --json
fireflies-pp-cli --profile briefing transcripts list
fireflies-pp-cli profile list --json
fireflies-pp-cli profile show briefing
fireflies-pp-cli profile delete briefing --yes显式标志参数始终优先于配置文件值;配置文件值优先于默认值。会在下列出所有可用配置文件,因此内省Agent可在运行时发现这些配置文件。
agent-contextavailable_profilesExit 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, , or
help→ show--helpoutputfireflies-pp-cli --help - Starts with → ends with
install→ MCP installation; otherwise → see Prerequisites abovemcp - Anything else → Direct Use (execute as CLI command with )
--agent
解析的规则:
$ARGUMENTS- 为空、或
help→ 显示--help输出fireflies-pp-cli --help - 以开头 → 如果以
install结尾 → 安装MCP;否则 → 参见上方的前提条件部分mcp - 其他情况 → 直接使用(添加参数执行CLI命令)
--agent
MCP Server Installation
MCP服务器安装
- Install the MCP server:
bash
go install github.com/mvanhorn/printing-press-library/library/productivity/fireflies/cmd/fireflies-pp-mcp@latest - Register with Claude Code:
bash
claude mcp add fireflies-pp-mcp -- fireflies-pp-mcp - Verify:
claude mcp list
- 安装MCP服务器:
bash
go install github.com/mvanhorn/printing-press-library/library/productivity/fireflies/cmd/fireflies-pp-mcp@latest - 在Claude Code中注册:
bash
claude mcp add fireflies-pp-mcp -- fireflies-pp-mcp - 验证:
claude mcp list
Direct Use
直接使用
- Check if installed: If not found, offer to install (see Prerequisites at the top of this skill).
which fireflies-pp-cli - Match the user query to the best command from the Unique Capabilities and Command Reference above.
- Execute with the flag:
--agentbashfireflies-pp-cli <command> [subcommand] [args] --agent - If ambiguous, drill into subcommand help: .
fireflies-pp-cli <command> --help
- 检查是否已安装:如果未找到,提供安装选项(参见顶部的前提条件部分)。
which fireflies-pp-cli - 将用户查询与上方独特功能和命令参考中最匹配的命令进行匹配。
- 添加参数执行命令:
--agentbashfireflies-pp-cli <command> [subcommand] [args] --agent - 如果存在歧义,查看子命令帮助:。
fireflies-pp-cli <command> --help