open-edit

open-edit

You author the piece yourself, as an HTML page, and render it with render. OpenEdit supplies what a
bare shell does not: VEED's hosted services on one login, measured tools for cutting and sound, and a
renderer that re-renders only the stretch you changed. openedit below is short for
npx @veedstudio/openedit-cli; every command explains its flags with --help.

Setup

Once per workspace, before the first command. WORKSPACE is the current project root, or the current
directory outside a project. It is done when your own init run below ends on ready — OPEN_EDIT_ROOT=…,
or when a session-opening note says
Open Edit preflight is ready and OPEN_EDIT_ROOT=<path>. No further preflight is needed; a note that
lists APPROVAL REQUIRED never means that, whatever else it quotes.

npx --yes @veedstudio/openedit-cli init --dry --workspace "$WORKSPACE"
npx --yes @veedstudio/openedit-cli init --workspace "$WORKSPACE"

Read the final preflight: line, not the exit code: ready — OPEN_EDIT_ROOT=… means go, and runs/
and the recorded preferences live under that root. If init prints APPROVAL REQUIRED, tell the user
every exact action and wait for an explicit yes, then run it again with --auto-approve. When the final
line says the user runs the install commands, --auto-approve cannot run them: give the user those
commands and run init again once they are done. Never install anything machine-global without that
yes, and never infer it from the render request.

One folder per piece

Keep everything a piece is made of under runs/<key>/: the page, its assets, renders, audio. The code
is the edit: that folder is how the user comes back later to change one scene or reuse the piece for
another video, so nothing it needs lives anywhere else.

Tools

Need	Command
A transcript with real per-word times	transcribe <video> [...] runs the provider recorded in $OPEN_EDIT_ROOT/.open-edit-prefs.json. None recorded (the command refuses and says so), "No VEED login found", or a failed run: read TRANSCRIPTION.md first
Remove, reorder or join takes	read CUT.md (speech-probe, apply-edl, retime-transcript)
Join whole clips whose shapes disagree	concat-videos (re-encodes to one canvas at 30 fps)
Look at a video, a page or a pile of images	frames <video> --at <sec,...> --sheet (one sheet of those moments; --images for a folder of references), render --stills
Cut the subject out of its background	background-removal (the free VEED route; when it cannot run, the command stops with fal's price, and only --fal buys)
A presenter speaking a script	Fabric: read FABRIC.md first
New audio on a face	lipsync
Any fal model: images, video, music, voice, effects	fal schema <model>, then fal run <model> --input <json or @file> --run runs/<key> (--batch <jobs.json> for many); local files in the input are uploaded for you
Web fonts as local files	fonts <Family> [...] --out <dir>
Real, licensed pictures	stills search, stills show, stills save
One soundtrack from several pieces	mix-audio runs/<key> (voice tracks duck the bed; mix-audio --help has the spec)
Sound on a render, at delivery loudness	mux-audio --video <render> --audio <source clip or built track> --out <file>
The piece in VEED's editor for the user to change, or a project they bring from it	read VEED.md (veed-project, veed-pull)

Fabric, background removal, lipsync and veed-project reuse the VEED transcription login: same veed.io
account, same stored token, no second sign-in. The editor hand-off's bookmarks run in the user's own VEED
session in the browser. background-removal --fal needs no VEED login at all.

Render

openedit render runs/<key>/index.html --out runs/<key>/out.mp4 --fps <fps> --duration <seconds>

The canvas is the page's #stage (or [data-stage]) element, captured at its own size, else
1920x1080. --width/--height instead capture that much of the page from its top-left corner and
ignore the stage. With footage, the canvas and frame rate are the source's own, and frames prints
both. Pass its frameRate (such as 30000/1001) to --fps, never the decimal beside it.

• The renderer owns time. It drives a virtual clock (performance.now, Date.now,
  requestAnimationFrame, timers, a seeded Math.random), sets every CSS and Web Animations
  animation to the frame's time and seeks GSAP's global timeline. Anything else that moves with time
  goes in window.__seek(t) (it may be async).
• It waits for fonts, images and videos before the first frame, and shows each <video> at the exact
  frame. Keep fonts and assets as files beside the page.
• --from <s> --to <s> re-renders only that stretch and reuses the rest. After a change, re-render what
  changed, not the piece.
• --stills 0.5,2,4 --sheet <file> shows moments without a full render. --transparent gives alpha.
• It fails loudly on a page error, a blank render or a Chrome that did not start; read the reason it
  prints. A load it lists as failed (a video, an image, a font) is a wrong render: fix it and re-render
  before delivering.
• The output is silent: mux-audio lays the sound on (build a many-piece track first with mix-audio).

No footage

If the user attached no video, read the ask before assuming one is needed:

• A clip is coming: wait for it.
• A talking head from a script: Fabric, per FABRIC.md.
• A clip from another model (anything on fal, their key and their bill): say in the same breath that
  captions are transcribed from the clip's speech, and most generators return silent clips.
• No video at all: build from stills, graphics, generated imagery and audio. That is a whole run.

If it is unclear which, ask.

Money

• VEED transcription consumes the VEED transcription credits of one workspace. On an account with
  several, the CLI will not pick: name the one the user chose with --workspace.
• Fabric consumes the AI Playground credits of the workspace chosen for it; FABRIC.md has its three stops.
• Every fal call (fal run, lipsync, background-removal --fal or --fast) bills the user's own fal
  account.
  Before the first paid call, say in one line what you will make and what it costs, and let them
  answer. Background removal's default route is free.
• Report what was spent, and on which account, when you deliver.

Talking to the user

One line when you start, then the deliverable's path and a sentence or two on the result. No
step-by-step progress and no internals: run keys, command names, raw tool output. Pass on in plain
terms a warning about the result, such as words transcribed without timings. If you must stop, say in
plain terms what is wrong on screen and what the options are.