CLI for agents

Pass the global --json flag when software consumes CLI output. A successful response contains schema_version, command, data, and, for paginated commands, pagination.

Find the meeting first

fmtr --json meetings list --query "weekly planning" --limit 10
fmtr --json meetings get MEETING_ID

List filtering matches titles and IDs without regard to case. For full-text search across notes, summaries, and transcripts, use meetings search. If several meetings match the user’s request, ask which one they mean.

Read only what you need

fmtr --json meetings note MEETING_ID --kind note
fmtr --json meetings note MEETING_ID --kind summary

Use meetings get when you also need metadata or action items.

Transcripts

fmtr --json meetings transcript MEETING_ID

This returns the complete speaker-labeled transcript in one response. Transcripts can be large, so do not request one unless the task needs it.

Check the setup

fmtr --json doctor

The report includes the CLI version, a ready flag, the resolved vault path, path health, and the number of sessions. It exits with status 1 when ready is false, while still writing the report to standard output.

For a non-default vault, use --vault-path DIR or FMTR_VAULT_PATH.

Write only when asked

fmtr --json meetings new --title "Weekly planning" --note notes.md
fmtr --json meetings note MEETING_ID --append notes.md
fmtr --json import recording.m4a --transcribe
fmtr --json transcribe MEETING_ID

meetings new creates a meeting and prints its ID; --note seeds the note body from a file or stdin (-). meetings note --set replaces the note body and --append extends it; both also accept - for stdin. import creates a meeting from an audio file, and --transcribe chains on-device transcription. transcribe replaces the meeting’s existing transcript, so run it only when the user wants that.

Export only when asked

fmtr meetings export MEETING_ID --format markdown --output meeting.md
fmtr meetings export MEETING_ID --format json --output meeting.json

Export refuses to replace an existing file. Pass --force only when the user has approved overwriting that exact path.

See the CLI reference for the full command contract.