Reference
Everything Cutwright has, read from its own source when this page was built: the director's tools from its registry, the operations and features from the edit's schema, the commands from cutwright help, the keys from the Studio. Each links to the part of the guide that explains it.
The director's tools · Edit operations · What an edit holds · Transitions · Picture · Generated segments · Graphics templates · Commands · Studio keys
The director's tools
What the director can read, run and propose, as each tool tells the director itself. Your decisions (approve, reject, undo, lock, unlock) are the director's to ask for, never to take.
footage_overviewreadsStart here, in every conversation. The project in one page: the people and their roles, every source (camera, mic) with its length and sync (and, when its frames are captioned, what a camera shows), which index layers are built, talk time per person, the outline when there is one, the edits and…
In the guide: Start here: How a cut is made
transcript_readreadsRead what is said, as sentence lines
[00:12:03.40–00:12:07.90] Name (s.id): text {flags}, a page of at most ~4k tokens at a time; the answer says whether there is a next page. from and to take a clock time, a sentence, word or outline id. words: true lists every word with its id, the pause…In the guide: Directing: What the director reads
transcript_searchreadsFind where something is said: sentences with every word of the query, best first (whole phrases score highest), top 20, with sentence ids and times. Optionally one speaker and a range. Use it to find a story, a name, a repeated line, instead of reading everything.
In the guide: Directing: What the director reads
takes_listreadsRepeated attempts at the same line, ranked best first with reasons (no fillers, stumbles, pace, level). Give a group id, or a point to list the groups near it. Keep the best take unless another has something it lacks, and say which and why.
In the guide: Directing: What the director reads
speakers_timelinereadsWho holds the floor when, as compact spans with overlaps marked, and talk time per person, for a range or the whole recording. Use it to plan camera switches and J/L cuts at changes of speaker.
In the guide: Directing: What the director reads
speaker_nameyour decisionRecord who a voice found on shared audio is, by its id from speakers_timeline (speaker_2): a project person, a new person with their name, or nobody (no one the project lists). Written to cutwright.json and committed; the next index run gives its words and turns that name.
In the guide: Directing: Voices on a shared mic
events_listreadsNon-speech sounds with times: laughter and applause (protect them and the beat before), breaths, silence and room tone (safe places to cut), coughs, noise and clipping (damage). Optionally one type and a range.
In the guide: Directing: What the director reads
quality_reportreadsHow each source sounds and looks: loudness, range, peak, noise floor, clipping, sharpness, exposure, and the words heard with low confidence (check those before you quote them). Optionally one source.
In the guide: Directing: What the director reads
outline_writerunsAfter reading the transcript, write the outline layer of the index: chapters (topic sections), and inside them beats, quotes worth keeping, tangents that could go, cold-open and clip candidates with scores. Each item spans from one sentence id to another; code works out the times.
In the guide: Directing: What the director reads
motion_listreadsMovements in the cameras' pictures, for cutting on action where nobody speaks: each with its id, when it starts, peaks and settles, its strength, where in the frame and whose, what the camera shows there (when frames are captioned), and its view from each other camera at the same moment, with how…
In the guide: Cutting: Cutting on action
inspectreadsLook closely before you commit to a cut: give cut (a segment's in or out point, in an edit or a proposal) or at (a word, sentence, movement or clock time, optionally to; or a Reelwright insert, insert.<slug>, or one of its shots, insert.<slug>/<shot>, optionally to another of its shots, for its…
In the guide: Directing: What the director reads
shorts_findreadsCandidates for shorts: the recording's strongest self-contained moments, scored in code from the index.
In the guide: Dressing the show: Shorts
graphics_listreadsThe project's graphics packages and the templates you can place with overlay_add: lower thirds, title and chapter cards, callouts, pull quotes, charts, diagrams, sketched marks over the picture, turning 3D objects, end credits (rolled or as cards), and the person's own artwork as a corner bug or…
In the guide: Dressing the show: Graphics
graphics_suggestreadsA graphics pass for a cut, scored in code from the index and drawn by the engine before you see it: a lower third for each person at their first sustained speech (name and title from the project), a chapter card at each outline chapter, a pull quote for each outline quote (word for word, whole…
In the guide: Dressing the show: Graphics
publish_suggestreadsWhen a cut is done and the person wants to post it: what it needs, laid out from the index.
In the guide: Dressing the show: The publish kit
publish_kitreads, Studio onlyAn edit's publish kit for the Publish panel, as data: chapters, titles, description, caption and hashtags as they post, the thumbnail's frame without words, and the ranked thumbnail frames.
In the guide: Dressing the show: The publish kit
translation_listreadsCaptions and chapters in another language. Without language: the cut's lines to translate, its captions as the source rules group them, each with the first and last word id a translation line cites, and the outline chapters it plays, by id.
In the guide: Dressing the show: Captions and chapters in other languages
inserts_listreadsThe project's Reelwright inserts: rendered stretches of cartoon episodes you can cut into the program as cutaways with insert_place, or, those with alpha, draw over it as covers while the footage goes on.
In the guide: Dressing the show: Cartoons from Reelwright
broll_findreadsFind B-roll to lay over the program by what it shows: give query in plain words (a whiteboard, hands on a remote).
In the guide: Dressing the show: B-roll
music_listreadsThe project's music tracks, which music_add lays under the program: each with its length, its loudness and the licence the person stated (or that none was). With edit, that edit's music cues too: where each comes in and goes, where it plays in the program and how often it ducks under speech.
In the guide: Dressing the show: Music
artwork_listreadsThe person's own artwork (their logo, a sponsor's mark) the project holds, which the bug and sponsor_card templates draw: each with its id, size, how light or dark it is, whether it has a transparent ground, the licence or permission stated (or that none was), and how far it stands from each…
In the guide: Dressing the show: Your logo and a sponsor's card
edit_proposeproposesPropose changes to one edit as operations by id, each with your reason: edit_create (first, for a new edit), segment_add (from and to anchors: word_start or word_end of a word id, or a shot), segment_remove, segment_move, segment_trim, words_remove and words_restore (first and last word ids of a…
In the guide: Directing: How a proposal reads
edit_statusreadsThe edits (segments, about how long, locks) and the change sets: what waits for the person's decision, what was applied lately. With edit: that edit's cut list in order, with locked segments marked.
In the guide: Directing: How a proposal reads
edit_diffreadsOne change set in full, a page at a time: its operations and reasons, the cut list after it, the changed segments as they play with ~~struck~~ words and how they were before, its flags, the self-reviews run on it, and its history.
In the guide: Directing: How a proposal reads
edit_renderrunsRender a cut so it can be heard and checked: an edit, or the edit as a proposal leaves it, with its graphics baked first and composited as the person would get them. A preview from the proxies by default (preset h264 or prores for the full picture), with a stem per mic for the words check.
In the guide: Directing: It checks its own cut
edit_checkrunsCheck a cut before you report on it, for an edit or a proposal: every anchor resolves, every removed span is inside its segment, every cut has a pause to snap into and nobody talking across it, the length against the brief, and then the render itself: when this version has no render it makes a…
In the guide: Directing: It checks its own cut
edit_critiquerunsThe critic pass on your own cut, for an edit or a proposal: measured findings with times (pauses kept, pace per segment, thoughts cut short, hard cuts on a change of speaker, cuts before laughter, fillers kept, lesser takes, long holds, chapters dropped, the story's share of the picture) and the…
In the guide: Directing: It checks its own cut
approveyour decisionApply a proposed change set to its edit: the edit is checked once more against the index, written at once or not at all, and committed in the project's git repository as the person's own git identity. Returns the applied change and its commit.
In the guide: Directing: Your decisions
rejectyour decisionDecline a proposed or stale change set; the edit is untouched and the proposal stays in the history as rejected. Only call this after the person has explicitly asked for this decision in their own words; never on your own judgment, and never to tidy up.
In the guide: Directing: Your decisions
undoyour decisionUndo an applied change set by applying its inverse as a new change set and commit (history is never rewritten; the edit comes back byte for byte). Undoing an undo re-applies the change it undid. Refused when the edit has changed since.
In the guide: Directing: Your decisions
lockyour decisionLock a segment of an edit (segment given) or the whole edit (no segment). Nothing changes a locked segment, or anything in a locked edit, until the person unlocks it; a segment's lock follows it when other segments move. Applied at once as its own change set and commit, so it can be undone.
In the guide: Directing: Your decisions
unlockyour decisionRemove the lock on a segment (segment given) or the lock on the whole edit (no segment), so it can change again. Applied at once as its own change set and commit, so it can be undone.
In the guide: Directing: Your decisions
program_compileruns, Studio onlyCompile an edit (edit.…), or the edit a proposal would leave (chg.…), into its frame-exact timeline in the project's cache, with every graphic placed in program frames. Writes only derived files.
In the guide: The Studio: Its panes
program_exportruns, Studio onlyExport an edit (edit.…), or the edit a proposal would leave (chg.…), as
cutwright exportdoes: OpenTimelineIO, Final Cut Pro 7 XML or a CMX 3600 EDL for an editing app, or SRT or WebVTT captions (the source's, or a translation's with language), into the project's cache (.cutwright/exports/).In the guide: The Studio: Its panes
Edit operations
The changes a proposal is made of. Each names words, shots, segments and graphics by id, with a reason you read before you approve it.
edit_createStart a new, empty edit (the change set's edit id); add segments after it.
In the guide: Directing: How a proposal reads
edit_renameRename the edit.
In the guide: Directing: How a proposal reads
captions_setSet the captions: none, broadcast (sentence captions) or word_by_word (the captions people post: one to three words a line, the spoken word lit), and whether they are burned into the picture.
In the guide: Dressing the show: Captions people post
caption_word_setFix one word of the captions, by its word id: its spelling (a name the transcript got wrong), its emphasis, or both. It changes only what the captions show; the index and the sound are untouched. Say text or emphasis again to change it; emphasis none takes the emphasis off.
In the guide: Dressing the show: Captions people post
sound_setSet how the render cleans the sound of every dialogue mic before the mix: off, gentle (the default) or strong. Each setting is applied per mic with its own measurements: a high-pass for rumble, noise reduction, de-essing, a gentle EQ and gentle compression.
In the guide: Cutting: Sound
segment_addAdd a segment: the recording from one anchor to another. Without after or before it goes at the end.
In the guide: Cutting: On words and pauses
generated_addAdd a generated segment: picture that is not footage, for the credits, a title card standing alone, or a beat of black between the story and what comes after it. fill is black, a colour role of a graphics package, or a still; length is a duration (durationMs, to the nearest frame) or fit graphics…
In the guide: Dressing the show: Credits, title cards and black
generated_setChange a generated segment: what is given (its fill, its length, its sound) replaces its value; what is not stays.
In the guide: Dressing the show: Credits, title cards and black
segment_removeTake a segment out of the program.
In the guide: Cutting: On words and pauses
segment_moveMove a segment to right after or right before another (exactly one of after and before).
In the guide: Cutting: On words and pauses
segment_trimMove a segment's start (from), its end (to), or both, to new anchors. Removed spans that fall outside it afterwards are dropped.
In the guide: Cutting: On words and pauses
words_removeCut words out of the middle of a segment, first and last inclusive, on one source: fillers, a stumble, a repeated phrase. Only that source's words go: what other people say on their own mics in that stretch stays, and the cut is made around it.
In the guide: Cutting: On words and pauses
words_restorePut removed words back: every removed word from first to last inclusive plays again.
In the guide: Cutting: On words and pauses
transition_setSet how a segment joins the one before it: hard, j (its sound leads its picture), l (the previous sound trails over it) or dissolve.
In the guide: Cutting: Transitions
picture_setSet which camera a segment shows.
In the guide: Cutting: Following the speaker
punch_ins_setTurn punch-ins on or off for the whole edit: where the picture stays on one camera across a cut that took time out (a jump cut), the pieces either side are framed wide and punched in on the speaker's face in turn, so each cut reads as a cut. auto (the default): on when the project has one camera,…
In the guide: Cutting: Punch-ins over jump cuts
framing_setSet how punch-ins frame one segment: auto (wide and punched in turn at each jump, as the edit's punch-ins say), wide (every piece wide: the frame's edges matter, such as hands, a product or a second person; its jumps stay) or punch (it opens punched in, for emphasis, and alternates from there,…
In the guide: Cutting: Punch-ins over jump cuts
overlay_addPut a graphic over the program: a template of the project's graphics package, its fields filled by the names the package declares (graphics_list shows them), up from start and gone by end. The package decides every colour, size, place and move; you choose the template, the words and the moment.
In the guide: Dressing the show: Graphics
overlay_updateChange a graphic: the fields given replace those fields' values (the others stay), and start, end or layer move it.
In the guide: Dressing the show: Graphics
overlay_removeTake a graphic off the program.
In the guide: Dressing the show: Graphics
insert_placeCut a Reelwright insert into the program as a cutaway, right after one segment or right before another, or draw it over the program as a cover from a word (one of after, before or cover): inserts_list shows the project's inserts, their shot ids and which have alpha. from and to trim it to a run…
In the guide: Dressing the show: Cartoons from Reelwright
insert_updateChange a placed insert: its trim (from, to), where it plays (after or before as a cutaway, cover over the program), its transition, its sound or its gain. What is not given stays.
In the guide: Dressing the show: Cartoons from Reelwright
insert_removeTake a placed insert out of the program.
In the guide: Dressing the show: Cartoons from Reelwright
colour_match_setSay how the edit matches its cameras' colour to one another (Edit.colour, ADR-0016): the compiler corrects each camera to look as the reference does, from the same skin and light the colour layer measured on both at the same instants, and only where the correction brings it closer on instants it…
In the guide: Cutting: Cameras matched in colour
active_picture_setCorrect which part of a camera's frame is picture (its active picture), when the contact sheets show a strip or a bar ingest left in, or real picture it cropped: area detected goes back to what ingest found, whole shows the whole frame, and custom shows the rectangle x, y, width, height, in…
In the guide: Cutting: Picture that is not the scene
music_addLay music under the program: a track of the project (music_list shows them and their licences) from where it comes in to where it has gone, named by what is in the program there: program_start, program_end, a segment's segment_start or segment_end, or the word_start or word_end of a word the…
In the guide: Dressing the show: Music
music_setChange a music cue: what is given replaces its value (a new start or end, fades, loop, levels, another track); what is not stays.
In the guide: Dressing the show: Music
music_removeTake a music cue out of the program.
In the guide: Dressing the show: Music
broll_addLay B-roll over the program while its sound runs on: a shot of footage (broll_find finds it by what its frames show; inspect on the shot id shows it) from start to end, words of the program. The picture cuts away to it and back; the dialogue never stops; graphics stay above it.
In the guide: Dressing the show: B-roll
broll_updateChange a B-roll: what is given replaces what it had (its shot, frame or through shot, where it starts or ends, its sound, its dissolve); the rest stays.
In the guide: Dressing the show: B-roll
broll_removeTake a B-roll off the program: the picture under it shows again.
In the guide: Dressing the show: B-roll
publish_setSet the cut's publish kit (Edit.publish): titles to choose from, the description's own words, the quotes they cite, a short's caption, hashtags, and the thumbnail (a frame publish_suggest ranked, and the words set over it). What you leave out keeps its value.
In the guide: Dressing the show: The publish kit
translation_addAdd the captions and chapter titles in a language the edit has no translation in yet (a BCP 47 tag: es, pt-BR).
In the guide: Dressing the show: Captions and chapters in other languages
translation_setChange a translation: each line given replaces the lines of that language that share a word with it (so a line is retranslated by giving it again over the same words, and two lines are joined by one over both), and each chapter title given replaces that chapter's. What you leave out stays.
In the guide: Dressing the show: Captions and chapters in other languages
translation_removeTake lines out of a translation (lines: a word of each, by id), or the whole translation (no lines).
In the guide: Dressing the show: Captions and chapters in other languages
What an edit holds
An edit is a document in your project (edits/<name>.json), changed only by approved proposals and kept in the project's git history.
briefWhat this cut is for, in the person's words and the director's reading of them.
In the guide: Directing: Say what the cut is for
segmentsThe program, in order. Each segment plays a stretch of the recording from one anchor to another, minus any removed word spans, or is generated: black, a colour or a still (since 1.7).
In the guide: Cutting: On words and pauses
captionsNone; broadcast: sentence captions; word_by_word: the captions people post, lines of one to three words broken by phrase, each word lit as it is said (karaoke), set by the graphics package's captions template (since 1.3).
In the guide: Dressing the show: Captions people post
soundHow the render treats the sound. Absent means the defaults.
In the guide: Cutting: Sound
musicMusic under the program: each cue a track of the project (a source ingested with role music) placed by what is in the program where it comes in and where it has gone, never by a timecode.
In the guide: Dressing the show: Music
brollB-roll: other footage laid over the program while its sound runs on (a product shot, the room, a screen, a clip shot another day), each from a shot of a source over a stretch of the program named by its words. The picture cuts away and back; the dialogue never stops; graphics stay above it.
In the guide: Dressing the show: B-roll
locksWhat the person has locked: a segment, by its id wherever it sits, or the whole edit when no segment is named. Only the person locks and unlocks. No change may alter or remove a locked segment, or change anything while the whole edit is locked; moving other segments around a locked one is allowed.
In the guide: Directing: Your decisions
overlaysGraphics over the program, each a template of a graphics package filled with data and anchored like a segment.
In the guide: Dressing the show: Graphics
insertsReelwright episodes cut into the program, each an Insert of the project (inserts/) placed by id.
In the guide: Dressing the show: Cartoons from Reelwright
picturesCorrections to the active picture ingest found for a camera (Source.picture), one per source: the rectangle of its frame this edit shows instead, where ingest left a strip or a bar in or cropped real picture. A source not listed shows what ingest found, or its whole frame.
In the guide: Cutting: Picture that is not the scene
punchInsDigital punch-ins, which turn jump cuts into cuts. Where the picture stays on one camera across a cut that took time out (a jump), the compiler frames the pieces either side of it alternately wide and punched in, a window scale times tighter on the speaker's face, so each cut reads as wide to…
In the guide: Cutting: Punch-ins over jump cuts
colourHow this edit matches its cameras' colour to one another: each camera is corrected to look as the reference camera does, from the skin and the near-neutral surfaces the colour layer measured on both at the same instants, and only where that correction, tried on patches it was not fitted to,…
In the guide: Cutting: Cameras matched in colour
publishWhat goes with the cut when it is posted: titles to choose from, the description's own words, the post's caption and hashtags, and the thumbnail.
In the guide: Dressing the show: The publish kit
translationsThe captions and chapter titles in other languages, one translation per language.
In the guide: Dressing the show: Captions and chapters in other languages
Transitions
How a segment joins the one before it.
hardPicture and sound cut together.
In the guide: Cutting: Transitions
jThis segment's picture starts later than its sound (the picture before holds over its first words).
In the guide: Cutting: Transitions
lThis segment's picture starts earlier (it shows under the last words before).
In the guide: Cutting: Transitions
dissolveA cross-dissolve. J and L move only the picture: the sound cuts where the segments meet either way, so neither brings back a word the cut clips.
In the guide: Cutting: Transitions
Picture
Which camera a segment shows.
follow_speakerThe compiler chooses, showing whoever holds the floor on a camera the faces layer finds them in (never an empty chair), a beat into each turn, the wide for crosstalk, laughs and chapter starts, another angle over a join that would jump, and the rule for each switch in the cut list.
In the guide: Cutting: Following the speaker
sourceOne camera throughout.
In the guide: Cutting: Following the speaker
switchesExplicit angle changes at anchors. source and switches are pins, kept as written.
In the guide: Cutting: Following the speaker
Generated segments
Picture that is not footage, a segment of its own.
blackIn the guide: Dressing the show: Credits, title cards and black
colorA colour role of a graphics package (night, the ground of its full-frame cards, unless another is named).
In the guide: Dressing the show: Credits, title cards and black
stillA picture from the project's media store, fitted to the frame.
In the guide: Dressing the show: Credits, title cards and black
Graphics templates
What a graphics package can draw. The package sets every colour, font, size and move.
lower_thirdA name and a line under it.
In the guide: Dressing the show: Graphics
title_cardThe show or episode title, full frame.
In the guide: Dressing the show: Credits, title cards and black
chapter_cardA numbered section title.
In the guide: Dressing the show: Graphics
calloutA short note with a leader to a point in the picture.
In the guide: Dressing the show: Graphics
pull_quoteA line someone said, large.
In the guide: Dressing the show: Graphics
chartA few numbers as bars, a line or one big figure, built on the beat.
In the guide: Dressing the show: Graphics
diagramLabelled boxes joined by arrows, laid out by the engine and revealed a step at a time.
In the guide: Dressing the show: Graphics
sketch_revealMarks drawn on over the picture as if by a pen (an underline, a circle, an arrow, an icon, a drawing from paths).
In the guide: Dressing the show: Graphics
3d_elementA lit object turning in three dimensions (a globe, a microphone, a title in relief).
In the guide: Dressing the show: Graphics
captionsThe captions people post, lines of one to three words lit word by word as they are said, drawn from the whole program's words (the core hands over the lines; its fields are a look and a position).
In the guide: Dressing the show: Captions people post
creditsThe end credits, headings, roles with their names and plain lines, as a roll scrolling at a reading speed the core works out or as cards page by page, usually over a generated segment.
In the guide: Dressing the show: Credits, title cards and black
thumbnailThe video's thumbnail, a few words set large over a frame of the program for the publish kit, never over the program itself.
In the guide: Dressing the show: The publish kit
bugThe person's own artwork (a logo, a sponsor's mark) small in a corner of the picture, for the whole program or a stretch of it, on the package's plate or straight on the picture.
In the guide: Dressing the show: Your logo and a sponsor's card
sponsor_cardA sponsor's artwork full frame on the package's ground, with a kicker over it and a line under it.
In the guide: Dressing the show: Your logo and a sponsor's card
Commands
The cutwright command line, as cutwright help lists it.
cutwright initMake a project folder with its own git history.
cutwright init <dir> [--name <name>] [--rate 30000/1001] [--size 1920x1080] [--no-git]In the guide: Start here: Getting started
cutwright ingestProbe, hash, proxy, extract audio and sync each original; progress as JSON lines.
cutwright ingest <project> <file or folder...> [--role <role>] [--person <slug>] [--proxy-encoder auto|h264_vaapi|h264_videotoolbox|h264_mf|mjpeg] [--no-sha256] [--no-commit]In the guide: Start here: Getting started
cutwright sourcesList the project's sources and their sync.
cutwright sources <project> [--json]In the guide: Start here: Getting started
cutwright sources syncPlace a source by hand: on another source's clock, or at an offset on the project clock (method manual, with the reason).
cutwright sources sync <project> <source> (--same-clock <source> | --offset-ms <n>) [--drift-ppm <x>] [--reason <text>] [--no-commit]In the guide: Start here: Getting started
cutwright speakersThe voices found on shared audio: who each is, and how known.
cutwright speakers <project> [--json]In the guide: Directing: Voices on a shared mic
cutwright speakers nameName a voice (speaker_2 is laura), or say it is no one listed; the next index run applies it.
cutwright speakers name <project> <voice> (<person> [--name <name>] | --nobody) [--no-commit]In the guide: Directing: Voices on a shared mic
cutwright transcriptWhat is said, a sentence a line, with who says it.
cutwright transcript <project> [--from <clock>] [--to <clock>]In the guide: Start here: Getting started
cutwright validateCheck documents: strict JSON, then the schema their kind names.
cutwright validate [--schemas <dir>]... <file...>In the guide: Render and export: Check
cutwright indexBuild the footage index; progress as JSON lines.
cutwright index <project> [--layers <a,b>] [--force]In the guide: Start here: Getting started
cutwright index statusSay which index layers are missing, current or stale.
cutwright index status <project>In the guide: Start here: Getting started
cutwright compileCompile an edit into a frame-exact timeline.
cutwright compile <project> <edit>In the guide: Render and export: Render
cutwright renderRender H.264 MP4 (or ProRes MOV, or a proxy preview); --stems also keeps a stem per mic for the words check.
cutwright render <project> <edit> [--preview | --prores] [--segment-frames <n>] [--stems]In the guide: Render and export: Render
cutwright exportWrite an interchange file or captions.
cutwright export <project> <edit> --format otio|fcpxml7|edl|srt|vtt [--out <file>]In the guide: Render and export: Files for your editing app
cutwright checkMeasure a render against its timeline (the words one mic at a time; --mix-words hears the mix instead).
cutwright check <project> <edit> [--preview | --prores] [--barcodes] [--goldens <file>] [--mix-words]In the guide: Render and export: Check
cutwright publishWrite the publish kit: chapters (YouTube, WebVTT, MP4 markers), titles, description, a short's caption, the thumbnail drawn and the ranked candidates, the MP4 with chapters when rendered.
cutwright publish <project> <edit> [--out <dir>] [--count <n>] [--every-package] [--renderer lavapipe|gpu|desktop]In the guide: Dressing the show: The publish kit
cutwright mcpServe the project's director tools over MCP on stdio, for Claude Code on your own plan (cutwright claude connect sets it up).
cutwright mcp <project>In the guide: Start here: Getting started
cutwright serveServe the project to the Studio: its director tools, jobs, live events and the in-app director (on your ANTHROPIC_API_KEY) as JSON-RPC 2.0 on stdio, one message per line.
cutwright serve <project>In the guide: The Studio: On the desktop and in the browser
cutwright claude statusIs Claude Code installed here and signed in with a Claude plan (it is asked; none of its files is read)? With a project: is Cutwright set up for it, running this checkout?
cutwright claude status [<project>] [--json]In the guide: Start here: Getting started
cutwright claude connectSet Claude Code up for the project, so
cd <project> && claudedirects it on your own plan. project (default) writes .mcp.json and .claude/settings.local.json into the project; local and user go through claude mcp add. Again changes nothing.cutwright claude connect <project> [--scope project|local|user] [--json]In the guide: Start here: Getting started
cutwright claude disconnectTake it out again.
cutwright claude disconnect <project> [--scope project|local|user] [--json]In the guide: Start here: Getting started
cutwright check-overlaysCheck an edit's overlays: typed fields, contrast, reading time, text that does not fit, the safe areas, cuts under a graphic.
cutwright check-overlays <project> <edit> [--instance <id>]In the guide: Render and export: Graphics as files
cutwright bake-overlayDraw the edit's overlays as straight-alpha frames and file each as ProRes 4444 and an FFV1 cache in the media store. Run it through tools/heavy.sh. The renderer is lavapipe, the canonical one, from a checkout, and desktop (this machine's GPU) in an installed app, whose Studio draws them.
cutwright bake-overlay <project> <edit> [--instance <id>] [--renderer lavapipe|gpu|desktop] [--keep-frames]In the guide: Render and export: Graphics as files
cutwright export-ografWrite a package's template as an EBU OGraf v1 graphic (manifest, module and fonts) that Resolve 21 keeps editable.
cutwright export-ograf <project> <package> [--template lower_third|title_card|chapter_card|pull_quote] [--out <dir>]In the guide: Render and export: Graphics as files
cutwright insert addRender a Reelwright episode (its scenes first to last) as an insert of the project: snapshot, compile, render, check every frame, conform to the project rate, encode with Cutwright's LGPL FFmpeg; writes inserts/<slug>.json. --alpha renders it with straight alpha, to cover the program: its set…
cutwright insert add <project> --show <dir> --episode <ep.id> [--scenes <first>..<last>] [--name <slug>] [--alpha] [--gpu] [--no-commit] [--keep-work]In the guide: Dressing the show: Cartoons from Reelwright
cutwright insert statusSay whether each insert is current, stale or missing.
cutwright insert status <project> [<insert>]In the guide: Dressing the show: Cartoons from Reelwright
cutwright insert refreshRender an insert again from its show as it is now.
cutwright insert refresh <project> <insert> [--gpu] [--no-commit]In the guide: Dressing the show: Cartoons from Reelwright
cutwright reelwright fetchDownload the pinned Reelwright release (or install it from an archive already here), check its SHA-256, and unpack it into the user cache. Only when you run it.
cutwright reelwright fetch [--from <archive>]In the guide: Dressing the show: Cartoons from Reelwright
cutwright reelwright whichSay which Reelwright Cutwright would run.
cutwright reelwright whichIn the guide: Dressing the show: Cartoons from Reelwright
cutwright artwork addAdd the person's own picture (a logo, a sponsor's mark) for the bug and sponsor_card templates: its picture by hash in the media store, measured by the engine; a licence stated is recorded, none is warned about wherever it is used.
cutwright artwork add <project> <file.png|file.svg> [--name <name>] [--licence <terms> [--attribution <credit>] [--licence-url <url>]] [--no-commit]In the guide: Dressing the show: Your logo and a sponsor's card
cutwright artwork listThe project's artwork, measured, and its licences.
cutwright artwork list <project>In the guide: Dressing the show: Your logo and a sponsor's card
cutwright doctorCheck that Cutwright is whole: its resources, an LGPL ffmpeg, ffprobe, parakeet-cli and the speech model, and where each was found. --report writes the same as JSON.
cutwright doctor [--report <file>]In the guide: What it needs: Is it all there?
cutwright versionPrint the Cutwright version.
cutwright versionIn the guide: What it needs: Is it all there?
cutwright helpShow this help.
cutwright helpIn the guide: What it needs: Is it all there?
Studio keys
The keys the Studio answers wherever the focus is but a text field.
SpaceIn the guide: The Studio: Space
JIn the guide: The Studio: J K L
KIn the guide: The Studio: J K L
LIn the guide: The Studio: J K L
←In the guide: The Studio: ← →
→In the guide: The Studio: ← →
HomeIn the guide: The Studio: Home End
EndIn the guide: The Studio: Home End
IIn the guide: The Studio: I O
OIn the guide: The Studio: I O
BIn the guide: The Studio: B
AIn the guide: The Studio: A
=In the guide: The Studio: + −
+In the guide: The Studio: + −
Keypad +In the guide: The Studio: + −
−In the guide: The Studio: + −
Keypad −In the guide: The Studio: + −
0In the guide: The Studio: 0
EscIn the guide: The Studio: Esc