Files
magnus919_agent-skills/fireflies/references/cli-reference.md
T
Magnus HedemarkandGitHub eadb82e069 fix(skills): reconcile fireflies CLI with live GraphQL schema (#290)
Fixes #289

- transcripts list: drop removed TranscriptsQueryScope type (scope is a
  String in the live schema), require [String!] for organizers and
  participants, add title/organizer-email/participant-email filters
- bites create: use the live transcript_Id argument name and the
  BitePrivacy enum (public, team, participants)
- add ergonomic commands for documented gaps found in the audit:
  askfred get, meetings update-channel, meetings share --expiry-days,
  live add-to (addToLiveMeeting), live soundbite (createLiveSoundbite),
  audio create-upload/confirm-upload (two-phase upload), users set-role
- add eval manifest (5 cases) to satisfy the modified-skill eval ratchet
- update SKILL.md, cli-reference, api-reference, source-index, workflows
  to match the audited surface and record the 2026-08-05 schema audit
2026-08-05 22:29:36 -04:00

2.0 KiB

CLI Reference

Run scripts/fireflies --help for the authoritative interface. Global flags work before or after subcommands: --json, --api-key, --endpoint, --timeout, --dry-run, --quiet, and --verbose. --json writes one JSON document to stdout; diagnostics are stderr-only.

Commands

Command Purpose
`query --document DOC [--variables JSON --variables-file PATH]`
mutation --document DOC ... --confirm Generic mutation
`transcripts list get
users, contacts, channels, groups, bites, apps Workspace/content reads; `users set-role --user-id ID --role admin
analytics, meetings active, live-action-items Analytics and live data
`meetings rename privacy
bites create, `live add add-to
`askfred threads get
audit-events, rule-executions Enterprise/admin queries
webhook verify Local signature check, no network
schema introspect Explicit GraphQL introspection

Examples

scripts/fireflies query --document 'query { user { name } }' --json
scripts/fireflies transcripts list --from-date 2026-01-01 --to-date 2026-01-31 --limit 50 --json
scripts/fireflies mutation --document 'mutation X { ... }' --confirm --dry-run --json
scripts/fireflies webhook verify --secret "$WEBHOOK_SECRET" --signature sha256=... --body payload.json --json

Variables must be a JSON object, inline or from a file. --dry-run returns the exact endpoint and payload and does not need an API key. Exit codes: 2 usage/input, 3 configuration, 4 transport/HTTP, 5 GraphQL errors, 6 confirmation refused.