MARIA-LITE Commands

/account

/api-secret --service <id> [--list] [--required]
    [/api-secret --service <id> --secret <key=value>]
    [/api-secret --service <id> --secrets <json_object>]
    [/api-secret --service <id> --openapi <https_url> --required]
    [--json]

/api-secret --service freee --required
    /api-secret --service freee --openapi https://.../openapi.yml --required
    /api-secret --service freee --secret "oauth_access_token=..."
    /api-secret --service freee --secrets "{"oauth_access_token":"..."}"

/assert existsAll=path1,path2 [existsAny=...] [missingAll=...] [missingAny=...] [jsonValidAll=...] [jsonValidAny=...] [base=root|cwd]

/auto-dev gen --goal "..." [--command-id <id>] [--sample] [--apply] [--json]
  
  Notes:
  - Default output is local (repo): artifacts/maria-ext-beta/packs/...
  - Use --sample to write into repo sample packs: maria-ext-beta/packs/...
  - It does not modify MARIA core code. Generated commands run via a generic beta extension runtime.

/blog generate [--date YYYYMMDD] [--since <YYYYMMDD|ISO>] [--slot 1|2|3] [--category benchmark|decision|reflection] [--apply] [--force] [--replace]
  /blog approve-publish [--revoke] (writes artifacts/blog/approval.flags.json)
  /blog sync [--in blogs] [--date YYYYMMDD] [--slot 1|2|3] [--project <id>] [--apply] [--publish] [--reauth-adc]

/bulk-register [--source all|api-guru|openapisearch] [--recompile] [--offset 0] [--match <substring>] [--format yaml|json]
    [--limit <n>] [--concurrency 4] [--update] [--apply] [--json]
    (shorthand flags: --api-guru, --openapisearch)

/caio [--profile <id>] [--provider <lmstudio|ollama|vllm>] [--model <name>] [--inputs <json|@file>] [--use-latest off|on|auto] [--auto-rerun off|on|auto] [--json] [--apply] "Your request"

/caio-clone init [--apply]
  /caio-clone boundary template [--out <file>] [--replace] [--apply]
  /caio-clone boundary set --file <boundary.json> [--apply]
  /caio-clone profile template [--out <file>] [--replace] [--apply]
  /caio-clone profile set --file <profile.json> [--apply]
  /caio-clone profile show
  /caio-clone policy d3 template [--out <file>] [--replace] [--apply]
  /caio-clone policy d3 set --file <d3-policy.json> [--apply]
  /caio-clone policy review-slo template [--out <file>] [--replace] [--apply]
  /caio-clone policy review-slo set --file <review-slo.json> [--apply]
  /caio-clone review init [--apply]
  /caio-clone review enqueue --file <candidate.json> [--reviewer <name>] [--apply]
  /caio-clone review approve|discard|edit --id <candidateId> --reviewer <name> [--notes <text>] [--apply]
  /caio-clone ingest template [--out <file>] [--replace] [--apply]
  /caio-clone ingest --file <decisionlog.json> [--apply]
  /caio-clone query template [--out <file>] [--replace] [--apply]
  /caio-clone query --file <decisionrequest.json> [--apply]
  
  Typical flow:
    1) /caio-clone init --apply
    2) /caio-clone boundary template --apply --replace (or boundary set --file ... --apply)
    3) /caio-clone ingest template --apply --replace (or ingest --file ... --apply)
    4) /caio-clone query template --apply --replace (or query --file ... --apply)
    5) /caio-clone query --file <decisionrequest.json> --apply
  
  Notes:
    - Without --apply, commands run in plan-only mode (no files written).
    - Query writes artifacts under artifacts/caio-clone/runs/<runId>/ when --apply.

/calculator <expression> [--mode basic|advanced|stats] [--data "1,2,3"] [--derivative-at <x>] [--integral-from <a> --integral-to <b>]

/ceo [--profile <id>] [--provider <lmstudio|ollama|vllm>] [--model <name>] [--inputs <json|@file>] [--use-latest off|on|auto] [--auto-rerun off|on|auto] [--json] [--apply] "Your question"

/ceo-clone init [--apply]
  /ceo-clone boundary template [--out <file>] [--replace] [--apply]
  /ceo-clone boundary set --file <boundary.json> [--apply]
  /ceo-clone profile template [--out <file>] [--replace] [--apply]
  /ceo-clone profile set --file <profile.json> [--apply]
  /ceo-clone profile show
  /ceo-clone policy d3 template [--out <file>] [--replace] [--apply]
  /ceo-clone policy d3 set --file <d3-policy.json> [--apply]
  /ceo-clone policy review-slo template [--out <file>] [--replace] [--apply]
  /ceo-clone policy review-slo set --file <review-slo.json> [--apply]
  /ceo-clone review init [--apply]
  /ceo-clone review enqueue --file <candidate.json> [--reviewer <name>] [--apply]
  /ceo-clone review approve|discard|edit --id <candidateId> --reviewer <name> [--notes <text>] [--apply]
  /ceo-clone ingest template [--out <file>] [--replace] [--apply]
  /ceo-clone ingest --file <decisionlog.json> [--apply]
  /ceo-clone query template [--out <file>] [--replace] [--apply]
  /ceo-clone query --file <decisionrequest.json> [--apply]
  
  Typical flow (minimum):
    1) /ceo-clone init --apply
    2) /ceo-clone boundary template --apply --replace (or boundary set --file ... --apply)
    3) Ingest decision logs (choose one):
       - /ceo-clone ingest template --apply --replace; then /ceo-clone ingest --file <decisionlog.json> --apply
       - /ceo-clone review init --apply; /ceo-clone review enqueue --file <candidate.json> --apply; /ceo-clone review approve --id <candidateId> --reviewer <name> --apply
    4) /ceo-clone query template --apply --replace; then /ceo-clone query --file <decisionrequest.json> --apply
  
  Optional setup (recommended):
    - /ceo-clone profile set --file <profile.json> --apply
    - /ceo-clone policy d3 set --file <d3-policy.json> --apply
    - /ceo-clone policy review-slo set --file <review-slo.json> --apply
  
  Notes:
    - Without --apply, commands run in plan-only mode (no files written).
    - Query writes artifacts under artifacts/ceo-clone/runs/<runId>/ when --apply.

/chat "message"

/code "request" [--plan-only] [--apply] [--files "path1,path2"]
    [--in-place] [--new-workspace] [--workspace "dirName|/abs/path"] [--set-repos-dir "/abs/path"]
    [--allow-new-top-level "dir1,dir2"] [--allow-new-dirs "a/b,c/d"]

/connect --service <id> [--action <actionId>] [--status] [--disconnect] [--secret-key <key>] [--authorization-url <url>] [--token-url <url>] [--pkce on|off] [--port 53682] [--json]
  Notes:
  - Requires OAuth app config via /api-secret for the service:
    /api-secret --service <id> --secret "oauth_client_id=..."
    /api-secret --service <id> --secret "oauth_client_secret=..."  (optional)
    /api-secret --service <id> --secret "<secretKey>_authorization_url=https://..."
    /api-secret --service <id> --secret "<secretKey>_authorize_url=https://..."  (alias)
    /api-secret --service <id> --secret "<secretKey>_token_url=https://..."

/coo [--profile <id>] [--provider <lmstudio|ollama|vllm>] [--model <name>] [--inputs <json|@file>] [--use-latest off|on|auto] [--auto-rerun off|on|auto] [--json] [--apply] "Your request"

/coo-clone init [--apply]
  /coo-clone boundary template [--out <file>] [--replace] [--apply]
  /coo-clone boundary set --file <boundary.json> [--apply]
  /coo-clone profile template [--out <file>] [--replace] [--apply]
  /coo-clone profile set --file <profile.json> [--apply]
  /coo-clone profile show
  /coo-clone policy d3 template [--out <file>] [--replace] [--apply]
  /coo-clone policy d3 set --file <d3-policy.json> [--apply]
  /coo-clone policy review-slo template [--out <file>] [--replace] [--apply]
  /coo-clone policy review-slo set --file <review-slo.json> [--apply]
  /coo-clone review init [--apply]
  /coo-clone review enqueue --file <candidate.json> [--reviewer <name>] [--apply]
  /coo-clone review approve|discard|edit --id <candidateId> --reviewer <name> [--notes <text>] [--apply]
  /coo-clone ingest template [--out <file>] [--replace] [--apply]
  /coo-clone ingest --file <decisionlog.json> [--apply]
  /coo-clone query template [--out <file>] [--replace] [--apply]
  /coo-clone query --file <decisionrequest.json> [--apply]
  
  Typical flow:
    1) /coo-clone init --apply
    2) /coo-clone boundary template --apply --replace (or boundary set --file ... --apply)
    3) /coo-clone ingest template --apply --replace (or ingest --file ... --apply)
    4) /coo-clone query template --apply --replace (or query --file ... --apply)
    5) /coo-clone query --file <decisionrequest.json> --apply
  
  Notes:
    - Without --apply, commands run in plan-only mode (no files written).
    - Query writes artifacts under artifacts/coo-clone/runs/<runId>/ when --apply.

/cpo [--profile <id>] [--provider <lmstudio|ollama|vllm>] [--model <name>] [--inputs <json|@file>] [--use-latest off|on|auto] [--auto-rerun off|on|auto] [--json] [--apply] "Your request"

/cpo-clone init [--apply]
  /cpo-clone boundary template [--out <file>] [--replace] [--apply]
  /cpo-clone boundary set --file <boundary.json> [--apply]
  /cpo-clone profile template [--out <file>] [--replace] [--apply]
  /cpo-clone profile set --file <profile.json> [--apply]
  /cpo-clone profile show
  /cpo-clone policy d3 template [--out <file>] [--replace] [--apply]
  /cpo-clone policy d3 set --file <d3-policy.json> [--apply]
  /cpo-clone policy review-slo template [--out <file>] [--replace] [--apply]
  /cpo-clone policy review-slo set --file <review-slo.json> [--apply]
  /cpo-clone review init [--apply]
  /cpo-clone review enqueue --file <candidate.json> [--reviewer <name>] [--apply]
  /cpo-clone review approve|discard|edit --id <candidateId> --reviewer <name> [--notes <text>] [--apply]
  /cpo-clone ingest template [--out <file>] [--replace] [--apply]
  /cpo-clone ingest --file <decisionlog.json> [--apply]
  /cpo-clone query template [--out <file>] [--replace] [--apply]
  /cpo-clone query --file <decisionrequest.json> [--apply]
  
  Typical flow:
    1) /cpo-clone init --apply
    2) /cpo-clone boundary template --apply --replace (or boundary set --file ... --apply)
    3) /cpo-clone ingest template --apply --replace (or ingest --file ... --apply)
    4) /cpo-clone query template --apply --replace (or query --file ... --apply)
    5) /cpo-clone query --file <decisionrequest.json> --apply
  
  Notes:
    - Without --apply, commands run in plan-only mode (no files written).
    - Query writes artifacts under artifacts/cpo-clone/runs/<runId>/ when --apply.

/cto [--profile <id>] [--use-latest off|on|auto] [--auto-rerun off|on|auto] [--json] [--apply] "Your question"

/cto-clone init [--apply]
  /cto-clone boundary template [--out <file>] [--replace] [--apply]
  /cto-clone boundary set --file <boundary.json> [--apply]
  /cto-clone profile template [--out <file>] [--replace] [--apply]
  /cto-clone profile set --file <profile.json> [--apply]
  /cto-clone profile show
  /cto-clone policy d3 template [--out <file>] [--replace] [--apply]
  /cto-clone policy d3 set --file <d3-policy.json> [--apply]
  /cto-clone policy review-slo template [--out <file>] [--replace] [--apply]
  /cto-clone policy review-slo set --file <review-slo.json> [--apply]
  /cto-clone review init [--apply]
  /cto-clone review enqueue --file <candidate.json> [--reviewer <name>] [--apply]
  /cto-clone review approve|discard|edit --id <candidateId> --reviewer <name> [--notes <text>] [--apply]
  /cto-clone ingest template [--out <file>] [--replace] [--apply]
  /cto-clone ingest --file <decisionlog.json> [--apply]
  /cto-clone query template [--out <file>] [--replace] [--apply]
  /cto-clone query --file <decisionrequest.json> [--apply]
  
  Typical flow:
    1) /cto-clone init --apply
    2) /cto-clone boundary template --apply --replace (or boundary set --file ... --apply)
    3) /cto-clone ingest template --apply --replace (or ingest --file ... --apply)
    4) /cto-clone query template --apply --replace (or query --file ... --apply)
    5) /cto-clone query --file <decisionrequest.json> --apply
  
  Notes:
    - Without --apply, commands run in plan-only mode (no files written).
    - Query writes artifacts under artifacts/cto-clone/runs/<runId>/ when --apply.

/cxo [--profile <id>] [--members "ceo,coo,caio,cfo"] "Decision question" [--json] [--apply]

NPM global installers:
    /deps npm-global --pkg "md-to-pdf" [--bin md-to-pdf] [--apply] [--json]
    /deps npm-global --pkg "@scope/pkg" [--version "1.2.3"] [--bin mycmd] [--apply] [--json]
  
  Notes:
  - Default is plan-only. Use --apply to install.
  - npm install always uses --legacy-peer-deps.

Notes:
  - default is local per-user store under artifacts/desires/desires.json
  - add --sample to use the repo sample store under src-lite/desires/desires.json
  
    /desire list [--sample] [--json]
    /desire set "<topic>" [--sample] [--raw] [--kind knowledge|creation] [--json]
    /desire remove <id> [--sample] [--json]
    /desire clear [--sample] [--json]

/desktop [--host 127.0.0.1] [--port 57597] [--no-open] [--json]
  
  Notes:
  - Default binds to 127.0.0.1 (local-only).
  - If --port is omitted, it tries 57597 and falls back to a random free port if needed.
  - If --port is 0, a random free port is chosen.
  - Use --no-open to avoid opening a browser tab.
  - Unlike /gui, /desktop supports parallel command execution.
  - Desktop files are stored at ~/.maria/desktop/.

/develop "<goal>" [--mode spec|plan|full] [--spec <path>] [--context <path>] [--product <id>] [--json] [--apply]

/docs --in @proposal/source.md --docx --pdf --apply
    /docs --title "ACME proposal notes" "Create talk track for the ACME meeting"

/doctor [--json] [--deep-dive] [--lint] [--typecheck] [--test] [--apply]
  Defaults: lint+typecheck. Use --deep-dive to add ai-proxy summary (no code changes).

1) Apply improvements (recommended):
     /evolve --kp [--direction "..."] [--dev] [--apply] [--kp-parallel 3] [--max-rounds 3] [--top-k 3] [--max-packs 3] [--json]
     /evolve --kp --synthesis [--dev] [--apply] [--ndc 3] [--pick 2] [--ndc3 "<csv_optional>"] [--json]
     /evolve --kp --update [--dev] [--apply] [--max-packs 3] [--max-queries 3] [--top-k 5] [--ndc3 320] [--json]
     /evolve --universe [--sample] [--apply] [--json]
     /evolve --desire [--apply] [--json]
     /evolve --skills [--apply] [--json]
     /evolve --persona [--sample] [--apply] [--direction "..."] [--max-topics 5] [--json]
     /evolve --kp --universe [--direction "..."] [--dev] [--sample] [--apply] [--json]
     - Uses /self-recognition gap topics (default 5) and fixes 1 topic per selected domain.
  
  2) Code evolve (beta):
     /evolve --code [--apply] [--json]
     /evolve --code --issues [--apply] [--json]
     - Generates a no-email-gated extension command under maria-ext-beta/ via /auto-dev (beta).
     - With --issues: create GitHub issue(s) only (no code generation).
  
  3) Legacy plan mode:
     /evolve "<goal>" [--json] [--apply]
  4) Status:
     /evolve status [--run <runId>] [--json]

/exam --in @exams/midterm.pdf "Answer all questions" --apply
    /exam --in @exam.txt --lang ja --apply
    /exam "What is the eigenvalue decomposition of a symmetric matrix?" --apply

/film "A romantic comedy misunderstanding on a space station" --duration 30 --aspect 16:9
    /film --in @docs/brief.md --duration 45 --aspect 9:16 --format mp4

Generate one skill:
    /gen-skills --cc --name <skill-name> [--description "..."] [--out <dir>] [--apply] [--json]
  
  Generate a workflow skill for /self-recognition -> /evolve:
    /gen-skills --cc --name self-recognition-evolve --apply
  
  Install samples into a target dir:
    /gen-skills --cc --sample --out .claude/skills --apply

/gh <args...>
  Example: /gh pr status

/git <args...>
  Example: /git status -sb

/gui [--host 127.0.0.1] [--port 57596] [--no-open] [--json]
  
  Notes:
  - Default binds to 127.0.0.1 (local-only).
  - If --port is omitted, it tries 57596 and falls back to a random free port if needed.
  - If --port is 0, a random free port is chosen.
  - Use --no-open to avoid opening a browser tab.

/help

/image "prompt" [--size 1024x1024] [--format webp|png|jpg] [--count 1..8] [--model <id>] [--seed N] [--ref @a.png,@b.jpg] [--out <dir>] [--path <file>] [--apply|--plan-only|--dry-run]

/import-origin --path <file_or_dir> [--name <label>] [--w] [--sample] [--apply] [--max-files 10000] [--json]
  Notes:
  - Default destination: artifacts/origin/<label>/ (and artifacts/origin/index.jsonl)
  - With --sample: src-lite/origin/<label>/ (and src-lite/origin/index.jsonl; included in npm publish)

/kp-generate "<topic>" [--dev] [--apply] [--max-rounds 10] [--top-k 10] [--max-packs 10] [--json]
  /kp-generate "<topic>" --local --path "<file_or_dir>" [--dev] [--apply] [--max-packs 10] [--json]

/kp-sync <packId|filename|relative/path...> [--dry-run] [--no-rebuild] [--json]

/kp-synthesis [--dev] [--apply] [--ndc 3] [--pick 2] [--ndc3 "<csv_optional>"] [--json]
  /kp-synthesis --ndc 3 --pick 1 --apply

/kp-update [--dev] [--apply] [--max-packs 3] [--max-queries 3] [--top-k 5] [--json]
  /kp-update "<hint_topic>" [--dev] [--apply] [--max-packs 3] [--json]

/list-api [--limit 50] [--service <id>] [--action <id>] [--search <query>] [--json]

/login [--device] [--force]

/logout [--force] [--all]

/manga "<theme>" [--type 4koma|pages] [--pages N] [--mode oneshot|serial]
    [--in @path1,@path2] [--reuse @path] [--color monochrome|full-color] [--size <WxH>] [--format webp|png|jpg] [--model <id>] [--seed N] [--out manga]
    [--persona <id>]
    --apply
    --plan-only

/music "prompt" [--type bgm|song] [--bpm 120] [--time 4/4] [--key <key>] [--bars 64] [--title "..."]
    [--instrument-palette acoustic|raw] [--soundfont /abs/path.sf2] [--persona <id>] [--out music] [--plan-only] [--apply] [--json]
  
  Notes:
  - Default behavior follows MARIA-LITE apply policy: it will run with implicit --apply unless you pass --plan-only.
  - WAV rendering prefers synth-js (GM instruments). Fallback is a simple waveform synth.
  - MP3 export uses ffmpeg. If missing, MARIA-LITE will try to auto-install ffmpeg (best-effort) then retry.
  - Instrument palette default is acoustic (to reduce electronic bias). Use --instrument-palette raw to keep model-chosen programs.
  - If no SoundFont is configured, /music will auto-download a default SoundFont on first run.
    - URL: https://archive.org/download/free-soundfonts-sf2-2019-04/airfont_380_final.sf2
    - Cache: ~/.maria/assets/music/airfont_380_final.sf2 (or MARIA_CONFIG_DIR)

/novel "<theme>" [--series <id|@path>] [--new-series] [--lang en|ja] [--format md|txt]
    [--genre <name>] [--chapters N] [--out <dir>] [--pdf] [--docx]
    [--in @requirements.txt] [--contest] [--persona <id>] [--envelope <jsonOr@path>] [--apply] [--replace]
  
    --pdf               Export as PDF
    --docx              Export as DOCX
    --in @path1,@path2  Contest requirements / reference materials (supports files and folders)
    --contest           Contest mode: generate based on contest requirements from --in
    --persona <id>      Use a registered persona as creative voice (default: auto)

/origin-fetch "<query>" [--label <name>] [--max-urls 6] [--sample] [--apply] [--json]
  /origin-fetch --url "https://a.com,https://b.com" [--label <name>] [--sample] [--apply]
  /origin-fetch --from-file urls.txt [--label <name>] [--sample] [--apply]
  Notes:
  - Default destination: artifacts/origin/<label>/
  - With --sample: src-lite/origin/<label>/ (publishable)
  - --url: Directly specify URLs (comma-separated). Skips AI discovery.
  - --from-file: Read URLs from a file (one per line). Skips AI discovery.
  - Run with --apply to download and write files.

/paper "Transformer architectures for time-series forecasting" --apply
    /paper --in @notes/draft.md --topic "quantum computing survey" --lang en --apply
    /paper --topic "自律型AIの自己認識" --lang ja --apply

/pdf from-md --in <file.md> [--out <file.pdf>] [--basedir <dir>]
  Example: /pdf from-md --in docs/report.md --out artifacts/report.pdf

/persona register [--self] [--lang ja|en] [--label <name>] [--avatar @img.png]  — Register persona
  /persona register --in @answers.txt [--self] [--lang ja|en] [--avatar @img.png]  — Register from file
  /persona generate "<description>" [--lang ja|en] [--avatar @img.png] [--no-avatar] [--avatar-style realistic|vector|anime|artistic]  — AI-generate a fictional persona (avatar auto-generated unless --no-avatar)
  /persona modify <name> "<instruction>" [--avatar @img.png]  — Modify an existing persona
  /persona modify <name> --auto  — Auto-fill empty fields using AI
  /persona modify <name>  — View current persona in editable format
  /persona list  — List all personas
  /persona list --samples  — List bundled sample personas
  /persona install <name>  — Install a sample or marketplace persona
  /persona share <name>  — Publish a persona to the marketplace
  /persona search "<query>"  — Search marketplace personas
  /persona show <name>  — Show persona details
  /persona remove <name>  — Remove a persona
  /persona set-default <name>  — Set default persona
  /persona memory add <name> "<content>" [--tags t1,t2] [--importance high|medium|low]  — Add memory
  /persona memory list <name>  — List memory entries
  /persona memory show <name>  — Show memory as prompt block
  /persona memory remove <name> <entry-id>  — Remove a memory entry

Marketplaces:
    /plugins marketplace add <source> [--scope user|project|local] --cc
    /plugins marketplace list --cc
    /plugins marketplace update <name> --cc
    /plugins marketplace remove <name> [--scope user|project|local] --cc
  
  Plugins:
    /plugins install <plugin>@<marketplace> [--scope user|project|local] --cc
    /plugins enable <plugin>@<marketplace> [--scope user|project|local] --cc
    /plugins disable <plugin>@<marketplace> [--scope user|project|local] --cc
    /plugins uninstall <plugin>@<marketplace> [--scope user|project|local] --cc
    /plugins list [--scope user|project|local] [--with-skills] [--save] [--save-path <path>] [--max-inline-chars <n>] --cc
  
  Marketplace publish (generate marketplace.json):
    /plugins marketplace publish --name <marketplace> --owner-name <name> [--owner-email <email>] --plugins-root <dir> [--out <dir>] --apply --cc

/proposal set-common-settings --bg #FFFFFF --fg #111111 --accent #22C55E --font "Noto Sans JP" --bg-image @assets/bg.png
    /proposal set-common-settings --title-bg-image @assets/bg-title.png
    /proposal set-common-settings --bg-image @assets/bg.png
    /proposal set-common-settings --title-title-shift "0.0,0.0,0.2,0.0" --body-title-shift "0.0,0.0,0.1,0.0"
    /proposal --target "ACME" --product-info @docs/product.md --customer-memo @docs/acme.md --slides 12 --pdf --pptx
  
  Subcommands:
    set-common-settings         (save/update common bg/fg/accent/font/bg-image for reuse)
  
  Options (generate):
    --target "<name>"           (required)
    --product-info @path1,@path2 (required; supports files and folders; comma-separated)
    --customer-memo @path1,@path2 (optional; supports files and folders; comma-separated)
    --slides N                  (default 10; 1..64)
    --title-slide true|false    (default true)
    --aspect 16:9|4:3           (default 16:9)
    --bg #RRGGBB                (optional; overrides common settings)
    --fg #RRGGBB                (optional; overrides common settings)
    --accent #RRGGBB            (optional; overrides common settings)
    --font "<name>"             (optional; overrides common settings)
    --bg-image @path            (optional; overrides common settings; compose background image png/jpg)
    --title-bg-image @path      (optional; overrides common settings; compose title background image png/jpg)
    --title-title-shift U,R,D,L     (optional; overrides common settings; % of slide; compose only)
    --title-subtitle-shift U,R,D,L  (optional; overrides common settings; % of slide; compose only)
    --body-title-shift U,R,D,L      (optional; overrides common settings; % of slide; compose only)
    --size WxH                  (default 1536x864)
    --format png|jpg|webp       (default png)
    --model <id>                (optional)
    --seed N                    (optional)
    --persona <id>          (optional; creative persona voice)
    --pdf
    --pptx
    --apply
    --plan-only

/recompile-api --service <id> [--update] [--apply] [--json]

/register-api --service <name> [--openapi <https_url>]
    [--registrable-domain <example.com>] [--allowed-hosts "*.example.com,api.example.com"]
    [--docs-url <https_url>] [--display-name <name>]
    [--secret <key=value>] [--secrets <json_object>]
    [--render] [--apply] [--force] [--json]

/reorganize --origin --apply
    /reorganize --kp --sample --apply --full
    /reorganize --universe --apply

/research "<query|url>" [--top-k 5] [--json]

/rollback [--count 1]
  /rollback --run <runId>
  /rollback --list [--json]
  
  Notes:
  - Rollback restores files to the state captured right before an apply run.
  - Use --run to roll back multiple checkpoints at once (newest -> that run, inclusive).

/run-api --service <id> --action <id> [--input <json>] [--input-file <path>]
    [--json]

/run-api --service openai --action openai.list_models --input "{}"

Status:
    /schedule
    /schedule status
  
  Configure schedule:
    /schedule set --every 24h --kp --desire [--direction "..."] [--max-topics 5] [--apply]
    /schedule set --daily-at 03:30 --kp --universe --desire [--apply]
    - With --apply: also starts (or restarts) the daemon immediately.
  
  Start/stop daemon:
    /schedule start
    /schedule stop
  
  Remove schedule (stop + delete config/state):
    /schedule remove
  
  Run once (foreground):
    /schedule run

/self-recognition [--kp] [--universe] [--code] [--desire] [--skills] [--persona] [--sample] [--direction "..."] [--max-topics 5] [--json]

Run a skill:
    /skills --name <skill-name> [args...]
    /skills --name <plugin-name:skill-name> [args...]

/slides --in @docs/brief.md --purpose "Internal briefing" --slides 10
    /slides --purpose "Sales proposal" "Create a 12-slide deck about our Q1 results"

/spreadsheet --in @data/report.md --title "Monthly Report" --xlsx --pdf --apply
    /spreadsheet --title "Budget" "Create a budget spreadsheet for Q1 2026"

/task-manager
    /task-manager --json
    /task-manager --flow <universe-name>

/twin list [--json]                         — Show configured services
  /twin presets [<query>] [--category <cat>] [--json] — Show / search available services
  /twin add <serviceId> [--json]               — Add a service from presets
  /twin remove <serviceId> [--json]            — Remove a service
  /twin status [--json]                        — Check connection status
  /twin setup [<serviceId>] [--json]           — Guided setup wizard

Subcommands:
  
  1) Genesis: AI generates a .uni program for the given topic (multi-agent team by default).
     /universe genesis "topic" --name <name> [--goal "success criteria"] [--code] [--sample] [--json]
     - Default: multi-agent team genesis (researcher → builder → reviewer loop).
     - With --code: single-agent genesis (one-shot LLM generation with retry).
     - Writes: universe.uni, universe.uni.ir.json, universe.manifest.json
     - Storage:
       - With --sample: src-lite/universe-code/sample/<name>/
       - Default      : artifacts/universe/<name>/
     - Note: requires authentication for ai-proxy. Run /login first.
  
  2) Inflate: compile and run a .uni universe (fallback to legacy flow if no .uni).
     /universe inflate --name <name> [--sample] [--rerun] [--in <text|@file|@f1,@f2>] [--answer "..."] [--apply] [--json]
     /universe inflate "<topic>" [--sample] [--rerun] [--in <text|@file|@f1,@f2>] [--answer "..."] [--apply] [--json]  (auto-picks best)
     - Without --apply: plan-only mode (no side effects).
     - With --apply   : agents execute tools (/code, /research, /deps, etc.).
     - With --rerun   : discard previous checkpoint and start a fresh run.
     - If blocked, it returns a question. Resume by passing --answer.
  
  3) Debug: parse, compile, validate a .uni file; AI auto-fix on errors.
     /universe debug --name <name> [--sample] [--apply]
     - Without --apply: shows diagnostics and suggested patches.
     - With --apply   : auto-patches the .uni file.
  
  4) Edit: view/edit the .uni source (opens editor in desktop mode).
     /universe edit --name <name> [--sample]
  
  5) Org chart: print the deterministic org structure (nodes + agents).
     /universe org-chart --name <name> [--sample] [--json]
  
  6) Multiverse: list all known universes (sample + artifacts).
     /universe multiverse [--json] [--save] [--no-save] [--save-path artifacts/multiverse.md]
  
  7) Revelation: append creator-provided knowledge into common-context.
     /universe revelation --name <name> --push <text|filepath> [--sample] [--json]

/universe genesis "Hiring process redesign" --name hiring_demo --sample
    /universe genesis "Hiring process redesign" --name hiring_demo --code --sample
    /universe inflate --name hiring_demo --sample --apply
    /universe debug --name hiring_demo --sample --apply
    /universe edit --name hiring_demo --sample
    /universe multiverse
    /universe revelation --name hiring_demo --sample --push "Always produce a final PDF."

/version [--json]

/video "prompt" [--duration 8] [--fps 24] [--res 720|1080|1280x720] [--aspect 16:9|9:16] [--format mp4|webm] [--model <id>] [--provider openai|google] [--seed N] [--remix <openai_video_id>] [--ref @image.png] [--out <dir>] [--path <file>] [--apply|--plan-only|--dry-run]

Generate notes (no writes):
    /vup
  
  Apply version bump + README update:
    /vup --apply
  
  Set explicit version:
    /vup --version 2.1.5 --apply