pp-fireflies

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/fireflies/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/". -->

# Fireflies.ai — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `fireflies-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 fireflies --cli-only
   ```
2. Verify: `fireflies-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/fireflies/cmd/fireflies-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 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.

## Unique Capabilities

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

### Local state that compounds
- **`transcripts search`** — Full-text search across all synced meeting transcripts without consuming any API quota.

  _Use to find every time a specific topic was mentioned across all meetings without burning rate-limited API calls._

  ```bash
  fireflies-pp-cli transcripts search "pricing objection" --agent --select id,title,dateString
  ```
- **`action-items list`** — Aggregate action items from all meetings in a date range — weekly commitment audit in one command.

  _Use at the end of the week to harvest all commitments made in meetings and push to a TODO file._

  ```bash
  fireflies-pp-cli action-items list --from 7 --agent
  ```
- **`transcripts find`** — Find meetings by participant email, channel name, keyword, or date range — all client-side, no broken API date filters.

  _Use 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._

  ```bash
  fireflies-pp-cli transcripts find --participant [email protected] --from 30 --processed-only --agent
  ```
- **`transcripts status`** — Show PROCESSED / PROCESSING / FAILED status for recent meetings upfront — know before you fetch.

  _Use when fetching same-day or next-morning meetings — avoids the loop of 'meeting not ready yet' failures._

  ```bash
  fireflies-pp-cli transcripts status --since 48h --agent
  ```
- **`topics list`** — Most frequent topics across all meetings in a date range — what is actually consuming meeting time.

  _Use during quarterly planning to identify recurring themes before deciding where to invest time._

  ```bash
  fireflies-pp-cli topics list --from 30 --top 15 --agent
  ```
- **`digest`** — Aggregate view of all recent meetings: titles, gists, topics, and action items in one structured output.

  _Use at session start or in a morning cron to orient on what happened yesterday before taking action._

  ```bash
  fireflies-pp-cli digest --since 24h --agent
  ```
- **`transcripts export`** — Export a transcript as markdown to a vault directory with auto-generated YYYY-MM-DD_title.md filename.

  _Use after a client meeting to save the formatted transcript directly to the right project folder._

  ```bash
  fireflies-pp-cli transcripts export abc123 --vault ~/vaults/VBT/Projects/1_Active/Ryder/transcripts/ --agent
  ```

### Person-centric intelligence
- **`person timeline`** — Chronological meeting history with a specific person — topics, action items, and talk ratio per meeting.

  _Use before a QBR or renewal call to reconstruct the full relationship history without reading every transcript._

  ```bash
  fireflies-pp-cli person timeline [email protected] --from 90 --agent
  ```

## Command Reference

**sync** — Sync API data to local SQLite

- `fireflies-pp-cli sync` — Sync transcripts, channels, and users to local SQLite
- `fireflies-pp-cli sync --full` — Full resync from scratch
- `fireflies-pp-cli sync --resources transcripts,channels` — Sync specific resources

**transcripts** — List, search, and manage meeting transcripts

- `fireflies-pp-cli transcripts list` — List transcripts from local store
- `fireflies-pp-cli transcripts get <id>` — Get a transcript from local store (or API with --live)
- `fireflies-pp-cli transcripts find` — Find by participant, channel, keyword, or date
- `fireflies-pp-cli transcripts search <query>` — Offline full-text search
- `fireflies-pp-cli transcripts recent` — Show recently processed transcripts
- `fireflies-pp-cli transcripts status` — Show PROCESSED / PROCESSING / FAILED status
- `fireflies-pp-cli transcripts pull <id>` — Fetch full transcript from API and store locally
- `fireflies-pp-cli transcripts export <id>` — Export as markdown to file or vault path
- `fireflies-pp-cli transcripts update <id>` — Update title or privacy
- `fireflies-pp-cli transcripts share <id>` — Share with external email addresses
- `fireflies-pp-cli transcripts delete <id>` — Delete a transcript

**summary** — AI-generated meeting summary

- `fireflies-pp-cli summary <id>` — Get summary (formats: overview, bullets, gist, topics, keywords, actions)

**action-items** — Extract action items

- `fireflies-pp-cli action-items get <id>` — Action items from a specific transcript
- `fireflies-pp-cli action-items list` — Aggregate action items across a date range

**topics** — Extract and analyze topics

- `fireflies-pp-cli topics get <id>` — Topics from a specific transcript
- `fireflies-pp-cli topics list` — Most frequent topics across all transcripts

**keywords** — AI-extracted keywords

- `fireflies-pp-cli keywords <id>` — Keywords for a transcript

**speakers** — Per-speaker analytics

- `fireflies-pp-cli speakers <id>` — Talk time, word count, filler words, questions per speaker

**analytics** — Meeting analytics

- `fireflies-pp-cli analytics team` — Team-wide analytics (requires Business+ plan)
- `fireflies-pp-cli analytics meeting <id>` — Per-meeting speaker analytics

**person** — Person-centric views

- `fireflies-pp-cli person timeline <email-or-name>` — Chronological meeting history with a person
- `fireflies-pp-cli person complaints <email-or-name>` — Negative-sentiment mentions across meetings

**digest** — Aggregate meeting briefing

- `fireflies-pp-cli digest` — Summary of all recent meetings in one view

**channels** — Channel management

- `fireflies-pp-cli channels <id>` — Get a single channel

**users** — User management

- `fireflies-pp-cli users` — Get user information


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

`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


### Morning triage: what happened in meetings yesterday

```bash
fireflies-pp-cli transcri