Muesli Agent
Apps & Automationmuesli-agentMuesli Agent is an Agent Skill for apps & automation published in the Muesli-HQ/muesli repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when working with local Muesli meetings, notes, dictations, audio-file transcription, or raw transcripts through the bundled `muesli-cli` CLI. Prefer this skill when a coding agent needs to transcribe local audio, inspect transcripts, summarize meetings with its own model, or write notes back into Muesli without requiring the user's API keys.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Muesli-HQ/muesli/blob/HEAD/skills/muesli-agent/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/muesli-agent, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Muesli Agent
Use the local muesli-cli CLI as the source of truth for meeting and dictation data.
CLI discovery
Resolve the binary in this order:
command -v muesli-clicommand -v mueslionly when the resolved path is a Homebrew cask alias toMuesli.app/Contents/MacOS/muesli-cli; verify withmuesli info/Applications/Muesli.app/Contents/MacOS/muesli-cli- A local SwiftPM build path inside this repo
If discovery is uncertain, run the candidate binary with info first and reject unrelated muesli executables.
Core workflow
- Inspect capabilities with
muesli-cli specif you do not know the exact subcommand shape. - To transcribe a local audio file, run
muesli-cli transcribe <file>and read plain transcript text from stdout. - Use
muesli-cli transcribe <file> --format jsonwhen you need duration, word count, model, warnings, summary, or saved meeting ID. - Add
--save-meetingto persist an imported meeting withsource = audio_import. - List candidate meetings with
muesli-cli meetings list --limit 10. - Fetch a full record with
muesli-cli meetings get <id>. - Use the coding agent's own model to analyze
rawTranscriptandformattedNotes. - If you want to persist improved notes, write markdown back with:
cat notes.md | muesli-cli meetings update-notes <id> --stdin- or
muesli-cli meetings update-notes <id> --file notes.md
Rules
- Treat CLI stdout as the API. Data commands are JSON by default;
transcribeis plain text by default, Markdown with--format markdown, and JSON with--format json. - Treat stderr as informational only.
- Do not mutate
rawTranscript; only updateformattedNotes. - Prefer the meeting transcript when
notesStateismissingorraw_transcript_fallback. - Use
--db-pathor--support-dironly when the default Muesli data location is wrong.
When to read references
Read references/cli-contract.md if you need the exact command tree, field definitions, or failure behavior.