Quickstart

Install Muesli

Download Muesli for your Apple Silicon Mac, move it to Applications, and open it to complete setup. The CLI ships inside the app. No separate CLI package is needed.

For recorded meetings, use the Mac app to capture the conversation. The commands below read saved meetings and transcribe existing audio files.

Make the CLI available

Run this in your terminal. The PATH change lasts for the current shell session. Add the export line to your shell configuration if you want it available in future sessions.

The spec command prints the command tree for your installed version. If you installed the app somewhere else, use that app’s Contents/MacOS directory.

export PATH="/Applications/Muesli.app/Contents/MacOS:$PATH"
muesli-cli spec

Read a meeting

List recent meetings, then use an ID from the result to fetch the transcript and saved notes. The number 42 below is an example; replace it with a real meeting ID.

muesli-cli meetings list --limit 10
muesli-cli meetings get 42

The JSON response includes data.rawTranscript, data.formattedNotes, and data.notesState. If notes are missing, start from the raw transcript.

Transcribe an audio file

Pass a local MP3, MP4, M4A, or WAV file. Speech recognition runs on your Mac; models may need to download on first use. The default output is plain text.

muesli-cli transcribe interview.m4a
muesli-cli transcribe interview.m4a --format json

Use --save-meeting to add the result to Muesli. Without that flag, file transcription does not create a meeting record.

Bring in your agent

Codex, Claude Code, and other coding agents with local shell access can call the same CLI. They can work through decisions, find action items, or turn a discussion into an implementation plan.

The agent uses its own model to analyze the transcript. You do not need to configure a Muesli summarization API key for that workflow. Your agent’s own subscription or API access still applies.

If a command does not work

Command not found: rerun the PATH export above, or use /Applications/Muesli.app/Contents/MacOS/muesli-cli directly.

Database unavailable: open Muesli once and check the paths reported by muesli-cli info. A different app installation or development build may use a different support directory.

Unknown command or model: check muesli-cli spec and muesli-cli transcribe --help. Available models and defaults depend on the installed release.