mulno CLI
mulno.exe is Mulno's headless core. Studio installs it beside itself (%LOCALAPPDATA%\Mulno Studio\mulno.exe), and the Claude Code plugin finds it there. Run mulno with no arguments to print its full help.
Commands
| Command | What it does |
|---|---|
mulno normalize <SESSION_DIR>… | Makes playback proxies: stream-copied MP4 aligned to the session timeline, written to the session's proxy/ folder. Skipped when they are up to date. |
mulno check-proxy <SESSION_DIR> | A developer check for barcoded test sessions: decodes the proxies and reports frame accuracy. |
mulno index <ROOT>… [--watch] | Indexes the sessions under each root into the local SQLite index. Only new and changed sessions are read; with --watch it keeps up until stopped. |
mulno search <ROOT> <QUERY>… | Full-text search over catalog keys, error messages, flag notes, meta and notes. Every word must match; each matches words that start with it, so boss_ro finds castle/boss_room. |
mulno mcp [--root <DIR>]… [--read-only] | Serves the session library to AI agents over MCP on stdin and stdout. See MCP tools. |
mulno transcribe <SESSION_DIR>… --provider <openai|elevenlabs> | Transcribes a session's mic track with a provider under your own account. Only the mic track leaves your machine, straight to the provider. --check-key checks the key and does nothing else. |
mulno build push <BUILD_DIR> --project <ID> | Chunks a Unity build folder (FastCDC, BLAKE3, zstd) and pushes the new chunks and a manifest, then registers the build and can move a branch to it with --branch. --dry-run chunks and reports without touching any bucket or the api, and needs no account. Pushing for real needs a workspace and a project on the web app: Push a build. |
mulno build gc --project <ID> … | Deletes chunks in a Private builds bucket that no registered build references and that are older than --grace hours (24 by default). --dry-run only lists. For a Private bucket only. |
Environment variables
| Variable | What it does |
|---|---|
MULNO_INDEX | The index database. Default %LOCALAPPDATA%\Mulno\index.sqlite, the one Studio uses. |
MULNO_FFMPEG | Where ffmpeg is, for normalize and frames. If it isn't set, mulno looks on PATH. |
MULNO_OPENAI_API_KEY, MULNO_ELEVENLABS_API_KEY | The provider key for transcribe --provider, when Studio hasn't linked one in Windows Credential Manager. |
MULNO_S3_ACCESS_KEY_ID, MULNO_S3_SECRET_ACCESS_KEY | Your own builds bucket's key for build push and build gc with --endpoint and --bucket. Never a command-line argument. |
MULNO_API_SESSION | A signed-in session's cookie value, for the api calls of build push. Not a CI token; see the CI sample. |
MULNO_EXE, MULNO_MCP_ROOT, MULNO_MCP_WRITE | Read by the Claude Code plugin and by Unity's Push window, not by mulno itself: where mulno.exe is, a library folder to index first, and whether the write tools are on. |
Register the MCP server by hand
PowerShell
claude mcp add mulno -- mulno mcp --root D:\playtests