Studio / Agent guide
Connect an agent
Studio holds no model and no key. Inside the app is a small program that speaks MCP over stdio: no port, nothing listening, started by the agent host you already use. The agent reads the film, looks at frames and proposes edits. Only you accept them.
0. Before you start
Two programs on the Mac: Studio 0.4 or later, dragged into Applications from the download (older builds have no door inside), and the agent. For Claude Code, from Anthropic's own installer:
curl -fsSL https://claude.ai/install.sh | bash Then run claude once and sign in. Any other MCP host works too; see step 1.
1. Register the door
With Claude Code. This downloads nothing: it tells Claude Code where the program inside Studio is,
and Claude Code starts it when a conversation needs it. --scope user makes it
reachable from every folder; without it the door exists only in the folder you ran the command in.
claude mcp add --scope user studio -- "/Applications/Life2Film Studio.app/Contents/MacOS/studio-cli" mcp Check with claude mcp list: studio should say it is connected.
With any other MCP host, the same program with the one argument mcp:
{
"mcpServers": {
"studio": {
"command": "/Applications/Life2Film Studio.app/Contents/MacOS/studio-cli",
"args": ["mcp"]
}
}
} 2. Add the skill
The skill tells the agent how to work here: the order to read a film in, how pieces are named, what to check before asking you. It ships inside the app:
mkdir -p ~/.claude/skills/life2film-studio
cp "/Applications/Life2Film Studio.app/Contents/Resources/skill/life2film-studio/SKILL.md" \
~/.claude/skills/life2film-studio/
Or read it here: SKILL.md. The server also hands every agent
its instructions on connect, plus three guides as MCP resources
(studio://guide/director, review, edits), so a host without
skills still gets the method.
3. Ask
Open the film in Studio so you can watch what happens, then ask in plain words. A few that work:
- “Make a film from the folder ~/Movies/trip/day1 and propose a three-minute cut.”
- “Review the cut at ~/Movies/trip/trip.otio. Propose nothing yet.”
- “At 14:36 the caption is wrong, it should say Seattle.”
- “Chapter 3 drags. Propose a version two minutes shorter.”
- “Bring the mix to -16 LUFS and tell me what you changed.”
- “Make a 60-second vertical from the Golden Gate chapter.”
Two prompts come with the server and appear in the host’s prompt list:
direct_film and review_cut.
What you see in the window
While an agent is connected, the window says so and marks the stretch it last looked at. A proposal is drawn on the timeline in amber: what goes is hatched, what comes in stands over the frame it would cover. Play shows the film as proposed before anything is written. Accept takes it, Drop Last removes the newest idea, and one undo puts the film back.
Every piece and chapter carries a name that no edit changes, so an agent that proposes five edits in a row still finds the shot it meant after the first one has split or moved it.
Notes are the other half. Pin a note to a moment, or paste a list of timecodes from a viewing; each stays on its frame through edits, and the agent reads them as its brief the next time it opens the film.
The twelve tools
timeline_readThe film: its outline, a stretch, the words said, what is at a moment, the files behind it, loudness, notes, each shot’s size and score, the frames that look aliketimeline_frameOne frame at a moment, as the window shows ittimeline_sheetA sheet of frames over a stretch, or the inside of one source filetimeline_proposeEdits checked against the film and kept beside it until you decidetimeline_acceptApply a proposal, after your yestimeline_rejectTake a proposal back, whole or its last ideatimeline_undoPut the film back as it was before the last accepted proposaltimeline_notePin a note to a moment or reply to onetimeline_newBegin a film, empty or from a folder of footage, or cut a reel out of another onetimeline_mixRender the sound with its plugin chains and measure itmix_pluginsThe effects that exist, their knobs and ready-made chainstimeline_filmExport: the whole film or a stretch, by presetWhat the agent cannot do
- Write the film without your accept.
- Look into files the film does not use.
- Hear. It reads loudness, pauses and measured levels, and says where a judgment needs ears.
- Touch your footage. Originals are only read.