mirror of https://github.com/magnus919/agent-skills.git synced 2026-09-17 06:26:31 +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

2.4 KiB

Raw Blame History

Workflows

List, Filter, and Read a Transcript

Use this to locate meetings and then inspect their content.

scripts/fireflies transcripts list --keyword roadmap --organizers owner@example.com --limit 10 --json
scripts/fireflies transcripts get transcript-id --json

The detailed query includes summary, speakers, sentences, and analytics.

Extract Actions and Summary

Use this for a currently live meeting or for a completed transcript.

scripts/fireflies live-action-items meeting-id --json
scripts/fireflies transcripts get transcript-id --json

Team Analytics

Use a bounded time range for trend reporting.

scripts/fireflies analytics --start 2026-01-01 --end 2026-01-31 --json

Upload Audio with Webhook Correlation

Use a publicly retrievable HTTPS media URL and a webhook endpoint you control. Preview first.

scripts/fireflies audio upload --url https://media.example/call.mp3 --webhook https://app.example/fireflies --client-reference-id import-42 --dry-run --json
scripts/fireflies audio upload --url https://media.example/call.mp3 --webhook https://app.example/fireflies --client-reference-id import-42 --confirm --json

Upload a File (Two-Phase)

Use this when the media is not on a public URL and you must push the bytes yourself.

scripts/fireflies audio create-upload --content-type audio/wav --file-size 5242880 --dry-run --json
scripts/fireflies audio create-upload --content-type audio/wav --file-size 5242880 --confirm --json
# PUT the file to upload_url from the response, then:
scripts/fireflies audio confirm-upload --meeting-id meeting-id --confirm --json

AskFred Conversation

Use AskFred for natural-language analysis when the account has AI credits.

scripts/fireflies askfred create --question 'What decisions were made?' --transcript-id transcript-id --confirm --json
scripts/fireflies askfred continue thread-id --question 'Who owns the follow-up?' --confirm --json

Generic GraphQL

Use this when a documented operation is newer than the CLI's ergonomic commands. Copy the document from Fireflies primary documentation, pass variables as JSON, and preview mutations before confirmation.

scripts/fireflies query --document 'query { user { name } }' --json
scripts/fireflies mutation --document 'mutation Example($input: SomeInput!) { someMutation(input: $input) { success } }' --variables '{"input":{}}' --dry-run --json

2.4 KiB Raw Blame History