mcut

CLI

Headless command-line tools for mcut project documents.

@mcut/cli operates on mcut project JSON files. It is for project document workflows that can run outside the browser.

bunx @mcut/cli --help

Commands

CommandPurpose
newScaffold a project document from a platform preset.
validateParse and lint a project file. Use --strict to fail on warnings.
summarizePrint the compact text rendering of a project.
applyDispatch one command or a batch of JSON commands.
captionsAdd caption elements from a transcript JSON file.
silence-cutsPlan or apply transcript-driven silence removal.
commandsList command tools or print one command schema.
presetsList platform presets.

Common workflow

bunx @mcut/cli new project.mcut.json --preset youtube
bunx @mcut/cli validate project.mcut.json
bunx @mcut/cli summarize project.mcut.json

Apply a command batch from a file:

bunx @mcut/cli apply project.mcut.json commands.json

Preview a command batch without saving:

bunx @mcut/cli apply project.mcut.json commands.json --dry-run

Command schemas

The CLI exposes the same command registry that the MCP server uses.

bunx @mcut/cli commands
bunx @mcut/cli commands --json
bunx @mcut/cli commands --name addElement

Use those schemas as the source of truth for low-level command payloads.

On this page