Vibecoding.cz Patrick Zandl o AI vývoji

Muse Code

Pracovní reference k terminálovému coding agentovi od Mety: slash příkazy, CLI flagy, modely, oprávnění, subagenti, skills, hooks, MCP, workflows a session messaging.

Ověřeno 17. 9. 2026 proti oficiálnímu changelogu a dokumentaci (verze 1.2.1)
Zdroje
Jazyk
Spuštění

muse

Přihlášení

/login

Výchozí model

muse-spark-1.2

Výchozí profil oprávnění

Auto-review

Headless běh

muse exec "…"

Instalace a přihlášení

PříkazCo udělá
museSpustí interaktivní terminálové UI v aktuálním projektu. Při prvním běhu nabídne přihlášení prohlížečem, nebo vložení API klíče.
/loginZnovu otevře volby přihlášení v běžící interaktivní session.
export META_API_KEY="<key>"Přihlášení API klíčem pro skripty a CI. Klíč z prostředí má vždy přednost před uloženým přihlášením z prohlížeče.
muse auth setUloží API klíč do úložiště bez nutnosti exportu v shellu.
muse logoutSmaže uložené přihlášení z prohlížeče i uložený klíč. Neodstraní META_API_KEY exportovaný v prostředí — ten zruš zvlášť.
muse initZapíše pravidla agenta projektu (AGENTS.md) do aktuálního adresáře. --dry-run jen ukáže návrh, --force přepíše existující soubor.
MMA → API klíčÚčty Meta Managed Account se nemohou přihlásit prohlížečem — musí použít API klíč.

Session: založení, větvení, kontext

Každý běh je append-only log událostí — přerušený nebo spadlý běh se přes /resume čistě přehraje a pokračuje.

Nejdůležitější příkazy
PříkazCo udělá
/newNová session, scrollback terminálu zůstane.
/clearNová session a vymaže scrollback. Konverzace, kontext, cíl i úkoly se resetují; paměť a pravidla na disku ne.
/resumeVybere uloženou session tohoto workspace a pokračuje v ní.
/resume --lastPokračuje v poslední session workspace.
/forkOdbočí novou session z aktuálního bodu. Zdrojová session běží dál beze změny; fork nepřebírá pohled.
/rewindVrátí konverzaci k dřívějšímu vstupu (stejný výběr jako dvojité Esc). Obnoví zprávu jako neodeslaný draft v nové session, soubory nemění.
/compactShrne dřívější historii LLM souhrnem a uvolní kontext. Pro model je ztrátové, scrollback na obrazovce nechá. Spouští hooky PreCompact/PostCompact.
Kontext a výstupy
PříkazCo udělá
/name [<name>]Ukáže nebo nastaví jméno session — stabilní jméno umožní ostatním session tě najít přes session messaging.
/side [<prompt>]Krátká paralelní konverzace stranou bez zásahu do hlavního vlákna. Alias /btw. Návrat je Ctrl+C. Najednou jen jedna.
/recapKrátké shrnutí dění od posledního shrnutí (jen buňka v přepisu, kontext modelu nemění).
/export transcriptZapíše čitelný přepis konverzace do .txt. S --out <path> zvolíš místo, s --redacted vyčistí tajemství.
/export trajectoryZapíše celý log session jako JSON (stejný dokument jako muse export pro aktuální session).
/copyZkopíruje markdown poslední dokončené odpovědi do schránky.
Stav a model
PříkazCo udělá
/statusSouhrnná karta session včetně řádku sandboxu při --disable-sandbox.
/usageSpotřeba a náklady, explicitně označené jako USD.
/modelsPřepne model uprostřed session (alternativa k --model).
/effortZmění reasoning effort uprostřed session (alternativa k --reasoning-effort).

Řízení běžícího tahu

Nemusíš čekat, až agent skončí. Esc přeruší jen tah — nenechá běžící terminály ani subagenty; na ty je /stop.

VstupCo udělá
EnterSteer: vloží text do právě běžícího tahu, agent ho zohlední v dalším kroku.
Alt+EnterQueue: podrží text až na příští tah místo aktuálního.
EscPřeruší běžící tah. Na prázdném composeru stáhne poslední zařazenou instrukci zpět k úpravě (retract).
Ctrl+CPřeruší tah jen z prázdného composeru; s textem vymaže vstup. V side konverzaci vrátí do hlavního vlákna.
/stopZastaví příslušnou práci na pozadí a terminály. Plošně neruší přímé subagenty — ty spravuj přes /tasks.
/tasksŠuplík úkolů na pozadí a přímých subagentů s akcemi pro vybraný řádek.
/subagentsPohled běžících i dokončených potomků (subagent tree).
/workflowsŘídicí místnost aktivních i dokončených multi-agent workflow běhů.
Alt+VDiktování do composeru (na macOS Option+V). Výchozí zapnuto na macOS, vypnuto na Linuxu, na Windows není.
ObrázkyVložený obrázek dostane štítek [Image #N], na který se můžeš odvolat („co je na [Image #2]?“). Štítky přežijí resume, fork i rewind.

Cíle, plánování a dotazy

PříkazCo udělá
/goal <objective>Nastaví cíl session — runtime drží agenta u cíle i přes více tahů a před dokončením vyžaduje kontrolu požadavek po požadavku. Esc nedokončený cíl automaticky pozastaví, /goal resume ho obnoví.
/goal · edit · pause · resume · clearZobrazí, upraví, pozastaví, obnoví nebo zahodí aktuální cíl.
/loop 10m /run-testsNaplánuje opakovaný prompt (interval 5m/1h/2d, nebo plný 5-políčkový cron). Bez frekvence běží každých 10 minut; výskyt během aktivního běhu se přeskočí. Úlohy expirují po 7 dnech.
/planVestavěná skill: úkol převede v ukotvený plán a zastaví se ke schválení, pak se staví.
Upřesňující dotazyKdyž agent potřebuje rozhodnutí, položí 1–3 otázky s volbami: čísla vybírají, Space přepíná multi-select, Tab přidá poznámku, ←/→ mění otázku, Enter odešle, Esc přeruší.

CLI: interaktivně a headless

Dva povrchy s oddělenými sadami flagů: interaktivní TUI (muse …) a headless běh (muse exec …). Headless běh nemá koho se zeptat — zvol politiku, která doběhne bez obsluhy.

Běh a model
Příkaz / flagCo udělá
muse exec "<prompt>"Jeden prompt do dokončení bez UI — pro skripty, joby a CI. S --json vypisuje JSONL události, s --prompt-file <path> čte zadání ze souboru.
--model <id>Model pro běh (výchozí muse-spark-1.2). Bere libovolné ID; neznámé použije rozumná předpokládaná metadata.
--reasoning-effort <level>Hloubka uvažování: none, minimal, low, medium, high (výchozí), xhigh, max, ultra.
--max-model-steps <n>Jen muse exec: strop práce, aby se zaseknutá úloha netočila donekonečna.
Oprávnění a sandbox
Příkaz / flagCo udělá
--approval-mode <mode>on-request (výchozí) · untrusted (striktnější pro shell) · never (nic se nezastavuje).
--approval-judge <on|off>Vypnutím pošle každé rozhodnutí tobě místo automatickému reviewerovi.
--sandbox-network <mode>proxy-only (výchozí, souhlas per destinace) · restricted (bez sítě) · enabled (plná síť).
--disable-approvalPřeskočí schvalovací prompty, sandbox nechá zapnutý. Vhodné pro automatizaci v izolaci.
--disable-sandboxNechá schvalování, vypne sandbox (i pro file nástroje a síť). Start i /status to přiznají.
--yoloVypne schvalování i sandbox a důvěřuje workspace (= profil Unrestricted). Jen v izolovaném prostředí, nikdy na stanici s reálnými tajemstvími.
Workspace a session
Příkaz / flagCo udělá
--trust-workspaceNačte project skills, pravidla a hooky checkoutu pro tento běh.
--workspace <path>Ukoření workspace nástrojů na danou cestu (policy-gated).
--no-session-logBěh bez uloženého logu: bez resume, trajectory exportu, pojmenování, peer messaging a retained recovery workflow.
--subagent-worktree-isolationKompatibilní flag — izolaci stejně žádáš per subagent, flag ji nevynutí všem.
muse -wSession ve vlastním Git worktree z HEAD — pro paralelní zápisy více session.
muse resumeOtevře interaktivní UI — není headless povrch. Headless pokračování je muse exec --session-id <uuid>.
muse export --session <uuid>Neinteraktivní export běhu (--out run.json). Při jiném workspace vyžaduje --allow-workspace-switch.
muse trace inspectZpětná inspekce uloženého logu session.
exit kódy exec0 tah doběhl · 1 selhal/zrušen (včetně limitu --max-model-steps) · 2 chyba použití · 130/143 na SIGINT/SIGTERM. 0 neznamená správnost — hlídej vlastní testy.

Modely a reasoning effort

VolbaCo znamená
muse-spark-1.2Výchozí model. Přepíšeš ho flagem --model, příkazem /models nebo nastavením.
none · minimal · lowMělké úrovně pro rychlé, levné tahy. none Meta provider nepřijímá, ostatní provideri ho podporovat mohou.
medium · highhigh je výchozí — vyvážený poměr latence a hloubky pro běžnou práci.
xhigh · maxxhigh je prémiová přesnost, max nejhlubší uvažování. Vynucené max se posílá modelu tak, jak je — nepodporovaná hodnota vrátí chybu providera.
ultraKlientské nastavení: mapuje se na nejvyšší tier každého providera a může agresivněji delegovat. Kde provider nestačí, běží jako xhigh.
/effort · show_reasoning/effort mění effort uprostřed session. Živý jednořádkový souhrn uvažování je zapnutý; plné reasoning do přepisu zapne až show_reasoning v nastavení.
MUSE_TRANSPORT_TRACE=1Ladění volání modelu: surové řádky požadavků a odpovědí na stderr, tajemství vyčištěná.
/themeVzhled terminálu včetně řádku pozadí (auto / light / dark), ukládá se jako tui.terminal_background.

Konfigurace, pravidla a paměť

Nastavení stroje jednou, instrukce projektu s repem. settings.json musí obsahovat "schema_version": 1 — bez něj každý příkaz při startu selže.

Soubor / klíčK čemu slouží
~/.config/muse/settings.jsonUživatelské nastavení: výchozí model, TUI předvolby, permissions.default_profile, MCP servery, hooks blok + managed_hooks_path, runtime_capabilities, telemetrie.
agents.execution_capacityKolik agentů smí běžet v jednom stromu najednou: 1–64, výchozí 8 včetně roota. Nenastavený ultra root používá 64.
muse config validateKontrola enterprise spravovaného dokumentu: muse config validate --plane <defaults|policy> --file <path>, stav přes muse config status.
AGENTS.mdPravidla projektu. V každé úrovni platí první existující z AGENTS.md, CLAUDE.md, .agents/AGENTS.md, .claude/CLAUDE.md. Při konfliktu vítězí projekt nad uživatelem a hlubší soubor nad mělčím. Na nedůvěryhodném checkoutu se nenačtou, dokud workspace nedůvěřuješ.
Project memorySdílená paměť v repu: <repo>/.agents/memory/ — index MEMORY.md plus jeden Markdown na téma. Agent na startu dostane index (max 48 souborů) a čte cíleně.
Personal memoryOsobní poznámky na stroji: výchozí personal-project (privátní, vázané na projekt) a machine-wide personal napříč projekty.
Pozor: MEMORY.mdCommitnutá paměť se načte i v nedůvěryhodném workspace — ber ji jako prompt-injection plochu a u cizích checkoutů ji kontroluj.

Oprávnění a sandbox

Obě zábrany jsou výchozí zapnuté a fungují nezávisle: schvalování rozhoduje, sandbox na úrovni OS vymáhá. Děti (subagenti, workflow) dědí hranici vedoucí session a mohou ji jen zúžit.

Profil / režimChování
Auto-reviewVýchozí: stejný přístup jako Ask me, ale způsobilé žádosti rozhoduje automatický reviewer; když není dostupný, ptá se tebe.
Ask meKaždou způsobilou žádost rozhoduješ ty. Oba režimy běží v módu on-request.
UnrestrictedBez schvalování i sandboxu, workspace důvěryhodný — stejná pozice jako --yolo, jen do izolace.
Read-onlyAgent čte workspace, ale nezapisuje soubory ani nespouští příkazy s vedlejšími účinky.
on-requestVýchozí mód: běžné nerozpoznaně-nebezpečné shell fáze projdou v sandboxu, destruktivní a externě-spouštěcí vzory (např. rm -rf, ripgrep -z/--pre) se zastaví k posouzení. Kontrolují se i wrappery (env, setsid).
untrustedStriktnější: shell fáze bez odpovídajícího allow pravidla se zastaví vždy. Čtení souborů a zápisy v rámci workspace procházejí v každém módu.
neverNic se nezastavuje ke schválení — drží jen sandbox.
Allow once · Always · RejectRozsah důvěry při zastavení: jednou / pravidlo prefixu pro tento workspace / zamítnout celý příkaz. Deny vždy přebije allow; prefix interpretu (python, bash, node) jako široké allow uložit nelze.
SandboxmacOS Seatbelt, Linux bubblewrap, Windows sandbox (první init může chtít UAC). Zápis povolen do workspace a temp adresáře; .git, .muse a .agents zůstávají read-only.

Subagenti a pozorovatelé

Subagenta použij pro ohraničený, nezávisle ověřitelný úkol. Přísně sekvenční práci nech na jednom agentovi.

PravidloPraktický dopad
Sdílený checkoutDěti sdílejí checkout vedoucí session. Izolovaný worktree žádej, když paralelní děti zapisují; read-only děti nech ve sdíleném. Izolace nikdy tiše nepadne zpět na sdílený checkout.
Kapacita stromuVýchozí 8 agentů včetně roota (agents.execution_capacity 1–64). Plný strom spawn odmítne; přijaté dítě může ještě čekat na slot plánovače. Vnoučata sdílejí stejnou kapacitu.
Kooperativní rušeníZrušené dítě doběhne rozepsaný zápis; dítě, které nedojde k checkpointu, běží dál. Runtime žurnáluje spawn, změny stavu i zásahy.
PozorovateléČtyři na pozadí, všichni výchozí zapnutí: Memory recall, Skill recall, Goal tracking, Verification. Navrhují do dalšího tahu, nerozhodují. Každý přidává vlastní tokenovou spotřebu.
Todo připomínkyVýchozí zapnuté: model popostrčí k todo listu u vícekrokové práce.

Skills

Skill balí opakovaný postup do jednoho vyvolání. V session ho spustíš lomítkem; když ho úloze připomene pozorovatel, agent ho načte sám.

Vestavěné skills
Skill / příkazCo udělá
/planÚkol převede v ukotvený, rozhodnutelně-kompletní plán a zastaví se ke schválení.
/grillZátěžový pohovor nad plánem či návrhem; každé rozhodnutí zapíše do projektové dokumentace a skončí psanou smlouvou o rozsahu.
/tasteBrána kvality designu před tím, než asistent píše vizuální webový frontend.
/threejsPřibalené reference pro Three.js scény: geometrie, materiály, světla, textury, animace, loadery, shadery, post-processing, interakce.
/migratePřibalená skill: importuje poznámky paměti a MCP servery z Claude Code nebo Codexu. Doplňuje muse skills import, který přináší skilly.
Správa skills
Skill / příkazCo udělá
muse skills listVypíše všechny skilly ze všech zdrojů.
muse skills inspect <id>Detail jedné skill.
muse skills enable <id>Zapne skill (--scope project pro projektový rozsah).
muse skills install ./my-skillNainstaluje skill (--scope user pro celý účet). Předtím ověř přes muse skills validate ./my-skill.
muse skills import --from claudeImportuje skilly z jiného agenta (--from codex pro Codex).
Zdroje skillsBuilt-in · User ($XDG_CONFIG_HOME/muse/skills, ~/.agents/skills, i ~/.claude/skills a Codex cesty) · Project (<repo>/.agents/skills/<id>/SKILL.md, i .codex/.claude) · Plugin.

Hooks

Hook váže shell příkaz na událost životního cyklu. Příkaz hooku běží přímo tvým shellem MIMO sandbox i schvalování — přidávej jen příkazy, které jsi četl.

Zdroj / událostCo platí
Project: .muse/hooks.jsonHooky commitnuté v repu. Běží až po důvěře v project folder.
User: settingsTvoje strojové hooky z nastavení — bez zvláštního kroku důvěry.
Managed: managed_hooks_pathCentrálně spravovaný soubor; běží bez project-trust — kdo ovládá soubor, ovládá spouštění.
SessionStart · SessionEndStart a řádné ukončení. SessionEnd je observační: nemůže blokovat konec ani vstříknout kontext.
UserPromptSubmit · StopOdeslání promptu a zastavení tahu.
PreToolUse · PostToolUsePřed a po volání nástroje — místo pro check, formátování nebo blokaci bez změny agenta.
PostToolUseFailureSpustí se, když volání nástroje selže nebo spadne.
PermissionRequest · NotificationŽádost o oprávnění; Notification vystřelí, když agent potřebuje tvoje schválení — hook tě může upozornit.
PreLLMCall · PostLLMCallPřed a po volání modelu.
PreCompact · PostCompactPřed a po kompakci kontextu (i u ručního /compact).
SubagentStart · SubagentStopStart a konec subagenta.

MCP servery

MCP nástroje nejsou sandboxované — běží jako běžný child proces nebo přímé síťové spojení. Připojuj jen servery, kterým věříš. Schvalování platí, izolace ne.

Příkaz / klíčCo udělá
mcp_servers (settings)Deklarace serverů v settings.json: stdio (command, args, env) nebo streamable_http (url, headers), každý s enabled a mode. Příklad: {"mcp_servers": {"my-tools": {"transport": "stdio", "command": "my-mcp-server", "args": []}}}.
mode: required · optionalrequired je výchozí — pád serveru shodí celý běh. optional server při nedostupnosti přeskočí s varováním.
${VAR} · MUSE_SESSION_IDKonfigurace podporuje interpolaci proměnných prostředí; stdio servery dostanou MUSE_SESSION_ID.
/mcpŽivý inventář připojených MCP serverů a jejich nástrojů v přepisu.
read-only nástrojeNástroj, který server deklaruje jako read-only, běží v on-request bez schvalovacího promptu.
muse mcp login <server>OAuth 2.1 přihlášení ke vzdálenému MCP serveru v prohlížeči i headless. Tokeny se drží a obnovují samy; přihlášení z jiného terminálu se převezme bez restartu. Vypnutí auto-registrace klienta: mcp_oauth_dynamic_client_registration: false.
muse mcp logout <server>Odhlášení ze vzdáleného MCP serveru.

Workflows (multi-agent orchestrace)

Workflow zvol, když úloha těží z několika agentů nezávisle nebo po etapách — ne pro drobnou úpravu. Subagenti = přímí pomocníci leada; workflow = opakovatelná orchestrace s fázemi a syntézou.

PrvekJak na to
/workflowsŘídicí místnost: stav, čas, tokeny a postup dětí. Výběr J/K nebo šipky, otevření Enter, zrušení C, výsledek R, zavření Space/Esc. Uvnitř: pauza P, přeskočení dítěte X, restart dítěte R.
LimityAž 1 000 child volání za život workflow; aktivních najednou nejvýše 16 (odvozeno od CPU). Širší dávka se zařadí do fronty. Každé dítě volá model zvlášť — široké workflow stojí výrazně víc tokenů.
muse workflows saveUložení opakovaného postupu: muse workflows save review-change --from ./review-change.js --scope project do .agents/workflows/. Jméno: malá písmena, číslice, ./_/-, max 64 znaků. Načítá se při startu session — po uložení restartuj.
muse workflows listVýpis uložených workflow (projekt má přednost před user scope). Spusť z důvěryhodného workspace repozitáře.
muse workflows recoverObnova po restartu procesu: muse workflows recover <run-id> --session <session-id> --apply. Hotové kroky se znovu nepouštějí.
Tools > WorkflowsRežim v /settings: auto (může navrhnout i spustit) · explicit (jen na přímou žádost) · off (nástroj odebere ze session).
DostupnostVyžaduje build s workflow script enginem a rollout WorkflowTool. Veřejný balíček aarch64-apple-darwin engine neobsahuje — workflow tam nejsou.

Session messaging

Ohraničený kontext z jedné živé session do druhé. Každá si drží vlastní přepis, workspace, oprávnění i úkol — zpráva je neschválí nástroje, nedá souhlas ani nezmění oprávnění.

PrvekPravidla
/name <name>Jméno 3–32 znaků ASCII, začátek malým písmenem, jinak malá písmena, číslice a jednoduché pomlčky (ne na konci, ne dvě za sebou). Rezervováno: all, self, current. Bez --no-session-log — ta se messaging neúčastní.
DoručeníSteer aktivního tahu (výchozí) · queue na příští tah · notify only (jen zobraz a zaznamenej, bez vstupu do kontextu). Probuzení: když je příjemce idle (výchozí), případně na bezpečném bodě.
Schválení peeraNeověřený odesílatel může vyvolat prompt: Allow once · Reject once · Allow for this session · Block for this session. Nevyřízené žádosti expirují po 30 minutách + 30 minut cooldown.
RozsahStejný uživatel, stejný stroj macOS/Linux. Windows, headless a --no-session-log povrchy v peer listu nejsou. Prostý text do 8 192 bajtů; žádný cross-user ani cross-machine transport.
VzorceŽádost o review s konkrétním commitem · předání zjištěného omezení do aktivního tahu · oznámení hotovosti s žádostí o checklist a odpověď zpět (uveď jméno odesílající session).

Novinky podle verze

Výběr doložený oficiálním changelogem; plné znění včetně oprav je na dev.meta.ai. Nejnovější první.

VerzeCo přibyloZdroj
1.2.1 (aktuální)Diktování defaultně na macOS (Option+V, /voice) · příkaz /rewind · štítky [Image #N] · živý inventář /mcp · přibalená skill migrate · MUSE_TRANSPORT_TRACE=1 · přejmenování session přes protokol · patchSummary/patchRef u editů · session/setReasoningEffort · workflow v muse serve · výchozí profil Auto-review · read-only MCP bez promptu · ${VAR} interpolace a MUSE_SESSION_ID · model_provider v hoocích.Changelog · 1.2.1
1.1.1muse mcp login/logout (OAuth 2.1 ke vzdáleným MCP) · klikatelné markdown odkazy · řádek pozadí v /theme · nástroje work_status/work_stop pro vlastní práci agenta · todo připomínky defaultně · skills pro vyjasnění produktu a trvalé testy · /threejs · hook PostToolUseFailure · protokolové capabilities.userInputDialogs, item/readOutput, view/subscribe.Changelog · 1.1.1
0.2.1Rewind dvojitým Esc · automatický předvýběr schvalování (judge) · jednorázové povolení běhu mimo sandbox · muse config pro enterprise · skill pro Python prostředí · skill pro předání browser aplikací · env proměnné pro hooky · bezpečnost: git config/hooks repozitáře, kontrolní znaky ve skills, Unix sockety v sandboxu.Changelog · 0.2.1
0.1.0Startovní verze.Changelog · 0.1.0

Bezpečnostní hranice

PravidloPraktický dopad
--yolo jen v izolaciOdstraňuje obě vrstvy a důvěřuje workspace — načte AGENTS.md, pravidla a skills, které jsou na cizím checkoutu útočníkem ovládané instrukce. Nikdy na stanici s reálnými tajemstvími.
MCP bez sandboxuMCP servery běží mimo filesystem i síťový sandbox. Schvalování platí, izolace ne — připojuj jen důvěryhodné servery.
Hooky mimo zábranyPříkaz hooku běží shellem mimo sandbox i schvalování, jen s vyčištěným prostředím. Spravovaný soubor hooků ovládá spouštění bez project-trust.
Cizí paměť a pravidlaCommitnutá MEMORY.md se načte i nedůvěryhodně; project pravidla, skills a hooky až po důvěře. Obojí na cizím checkoutu nejdřív čti.
Zprávy peera nejsou příkazyZpráva jiné session neschválí nástroj, nedá souhlas, nezmění oprávnění a nevydává se za vstup uživatele. Citlivosti přes messaging nepřenášej.

Zdroje