mirror of https://github.com/magnus919/agent-skills.git synced 2026-09-16 05:56:30 +03:00

Files

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

evals

fix(skills): reconcile fireflies CLI with live GraphQL schema (#290 )

2026-08-05 22:29:36 -04:00

references

fix(skills): reconcile fireflies CLI with live GraphQL schema (#290 )

2026-08-05 22:29:36 -04:00

scripts

fix(skills): reconcile fireflies CLI with live GraphQL schema (#290 )

2026-08-05 22:29:36 -04:00

tests

fix(skills): reconcile fireflies CLI with live GraphQL schema (#290 )

2026-08-05 22:29:36 -04:00

README.md

feat(skills): add Fireflies API skill and CLI (#49 )

2026-07-15 17:19:10 -04:00

SKILL.md

fix(skills): reconcile fireflies CLI with live GraphQL schema (#290 )

2026-08-05 22:29:36 -04:00

README.md

Fireflies.ai: meeting intelligence from the terminal

Why Install This Skill

Turn Fireflies meetings into usable data without hand-copying notes. Search transcripts, inspect summaries and action items, review analytics, and ask focused questions with AskFred from a single dependency-free command line tool.

It also makes sensitive operations deliberate: every mutation requires an explicit confirmation, and every mutation can be previewed locally before it is sent.

What You Get

Path	What it provides
`scripts/fireflies`	Python 3.9+ GraphQL CLI with safe reads, mutations, dry-runs, and webhook verification
`references/api-reference.md`	API model, operation families, limits, and source links
`references/cli-reference.md`	Complete CLI contract and examples
`references/workflows.md`	Transcript, analytics, upload, AskFred, and GraphQL recipes
`references/webhook-security.md`	Webhooks V2 verification guidance
`references/troubleshooting.md`	Failure diagnosis and escalation boundaries

Quick Start

export FIREFLIES_API_KEY='...'
python3 scripts/fireflies transcripts list --keyword roadmap --limit 10 --json

Output is the Fireflies GraphQL response, for example:

{"data":{"transcripts":[{"id":"...","title":"Roadmap review"}]}}

Preview a change without calling the API:

python3 scripts/fireflies meetings rename transcript-id --title "Q3 roadmap" --dry-run --json

Triggers

Fireflies.ai transcripts, summaries, notes, contacts, channels, or analytics
AskFred questions about meeting content
Remote audio upload to Fireflies
Fireflies Webhooks V2 signature verification

Requirements

Python 3.9 or newer
A Fireflies API key in FIREFLIES_API_KEY for API calls
Network access to https://api.fireflies.ai/graphql
No third-party Python packages