v2.0.1 · 10 packages · macOS only

Eight Apple apps. One control plane.

Drive Final Cut Pro, Compressor, Motion, Pixelmator Pro, Logic Pro, Keynote, Pages, and Numbers from Claude — 153 tools across 10 published packages, 1173 tests, ≥75% coverage on every package.

Read the Handbook Browse npm packages

Install (full CLI)

npm install -g @creator-studio-os/creator-studio-os

Install (single app)

npm install @creator-studio-os/fcp

Run protocol

creator-studio-os protocol run brand-deck-minimal \ --project demo/csos-showcase/project.json

What it does

153 tools across 8 Apple Creator Studio apps — wired into cross-app composition protocols.

FCPXML authoring

Build FCPXML 1.14 timelines from JSON specs — assets, clips, titles, transitions, markers. Validate against the bundled DTD. Import into FCP in one command.

Headless Motion render

Clone .motn templates, patch title and subhead text via OZML edit (patchSiblingText handles Apple Compositions sibling layout), render to ProRes 4444 via Compressor headlessly.

Cross-app composite

brand-deck-minimal: Pixelmator brand cards + Motion ProRes 4444 lower-thirds composited via ffmpeg → Compressor final encode → ProRes MOV. 13-step idempotent pipeline with replay manifest.

9/9 smoke harness

Phase 0–8 smoke covers app health, Compressor encode, Motion clone+render, FCP round-trip diff, ledger, tool-compass discoverability (12 semantic queries), and protocol real-render with movEyeballGate.

Tool-compass ready

All 153 tool descriptions pass semantic retrieval — tool-compass finds the right tool from natural-language intent rather than scanning the full surface on every call.

No network calls

Runs entirely on-device. No telemetry, no analytics, no remote validation. DTD validation reads the bundled DTD from the FCP app bundle. macOS Automation permission gated at OS level.

The 10 packages on npm

v2.0.0 decomposed the monolith into focused, independently-versioned packages. Install only what you need.

Package	What it does	Tools
@creator-studio-os/creator-studio-os	Umbrella CLI — `creator-studio-os` binary, MCP serve, verify, smoke	—
@creator-studio-os/core	Shared runtime — AppleScript runners, project schema, ledger, errors	1
@creator-studio-os/fcp	Final Cut Pro — FCPXML 1.14 authoring, DTD validation, library introspection	22
@creator-studio-os/compressor	Compressor — headless encode with monitor JSON progress, preset binding	15
@creator-studio-os/motion	Motion — clone .motn templates, OZML edit (incl. patchSiblingText), render	10
@creator-studio-os/pixelmator	Pixelmator Pro — full sdef coverage, brand cards, layers, blend modes, ML ops	33
@creator-studio-os/keynote	Keynote — slide composition, theme binding, export to MOV/PDF, ML ops	56
@creator-studio-os/logic	Logic Pro — project automation, bounce, MIDI lane operations	3
@creator-studio-os/iwork-docs	Pages + Numbers — document automation, table I/O, export	10
@creator-studio-os/protocols	Cross-app pipelines — brand-deck-minimal, steam-trailer-minimal	3

Quick start

Install the full CLI

npm install -g @creator-studio-os/creator-studio-os
creator-studio-os verify

Or install just one app

# Single-app consumers can pull in only what they need
npm install @creator-studio-os/fcp
npm install @creator-studio-os/motion
npm install @creator-studio-os/pixelmator

MCP client config

{
  "mcpServers": {
    "creator-studio-os": {
      "command": "creator-studio-os",
      "args": ["serve"]
    }
  }
}

Run the brand-deck-minimal protocol

creator-studio-os protocol run brand-deck-minimal \
  --project demo/csos-showcase/project.json

# 13 steps: Pixelmator brand cards → Motion lower-thirds
# → FCPXML → FCP import → Compressor encode → MOV