Ffcli
@ruigomeseu
npx machina-cli add skill @ruigomeseu/ffcli --openclawffcli — Fireflies.ai CLI
Query meeting recordings, transcripts, and AI summaries from Fireflies.ai.
Setup
Install via Homebrew or npm:
brew install ruigomeseu/tap/ffcli
# or
npm install -g @ruigomeseu/ffcli
Authenticate with your Fireflies API key (get it from Settings → Developer Settings):
ffcli auth <your-api-key> # Store key locally (~/.config/ffcli/)
ffcli auth --check # Verify it works
Alternatively, set the FIREFLIES_API_KEY environment variable (takes precedence over stored config). In OpenClaw, configure it via skills.entries.ffcli.apiKey in openclaw.json.
Note: ffcli is a third-party CLI by @ruigomeseu (Homebrew tap or npm). Verify the source before installing: check the npm package or Homebrew tap repo for code review and publish history.
Commands
List meetings
ffcli list --limit 10 --md # Recent meetings
ffcli list --from 2026-02-01 --to 2026-02-12 --md # Date range
ffcli list --participant vinney@opennode.com --md # By participant
ffcli list --search "standup" --md # By title keyword
ffcli list --limit 5 --include-summaries # With AI summaries (JSON)
Show meeting detail
ffcli show <id> --md # Full detail (markdown)
ffcli show <id> --summary-only --md # Just AI summary
ffcli show <id> --transcript-only --md # Just transcript
ffcli show <id> --include-transcript --md # Detail + transcript
User info
ffcli me --md # Account info, transcript count
Scripting patterns
# Action items from recent meetings
ffcli list --limit 10 --include-summaries | jq '.[].summary.action_items'
# All meeting IDs from a date range
ffcli list --from 2026-02-01 --to 2026-02-07 | jq -r '.[].id'
# Export a summary to file
ffcli show <id> --summary-only --md > meeting-summary.md
Notes
- Default output is JSON. Use
--mdfor readable output. --include-summariesonlistadds AI summaries (increases response size).- Meeting IDs are needed for
show— get them fromlistfirst. - Dates are UTC in JSON output.
Overview
ffcli is a Fireflies.ai CLI to query meetings, transcripts, and AI summaries from the command line. It helps you quickly locate discussions, read transcripts, and extract action items. It supports listing meetings, showing full details, and exporting AI summaries.
How This Skill Works
Install via brew or npm and authenticate with your API key. Use commands like list and show to fetch meetings; default output is JSON, and add --md for a readable view. You can supply FIREFLIES_API_KEY directly or configure it in OpenClaw with openclaw.json.
When to Use It
- Search meetings by title, date, or participant with ffcli list
- View a full or partial transcript for a meeting with ffcli show <id>
- Read or export AI-generated summaries using --summary-only or --include-summaries
- Extract action items from recent meetings (e.g., using summary.action_items with jq)
- Look up what was discussed in a call by querying transcripts and summaries
Quick Start
- Step 1: Install ffcli via brew tap or npm and authenticate with your API key
- Step 2: List recent meetings to identify IDs (ffcli list --limit 5 --md)
- Step 3: Show a meeting's details or summary (ffcli show <id> --md or --summary-only --md); export if needed
Best Practices
- Use --md for readable output during exploration
- Limit results with --limit to manage response size
- Always fetch IDs first with list, then use show
- Enable --include-summaries when you need AI summaries
- Store and protect FIREFLIES_API_KEY, using env var or local config
Example Use Cases
- Find a stand-up meeting by keyword using: ffcli list --limit 10 --md --search standup
- Show a meeting's full detail: ffcli show <id> --md
- Export a meeting summary to file: ffcli show <id> --summary-only --md > meeting-summary.md
- Pipe list output to jq to extract action items: ffcli list --limit 10 --include-summaries | jq '.[].summary.action_items'
- Get account info: ffcli me --md
