Project Management
Eight tools for creating projects, loading project data, saving artifacts, triggering renders, previewing in Remotion Studio, and generating reviews.
init_project
Create a new animation project with the full folder structure and a project.json. A project represents one end-to-end motion deliverable: brief → storyboard → scenes → motion → renders → review.
- Name
title- Type
- string
- Description
Required. Human-readable project title.
- Name
slug- Type
- string
- Description
Required. URL-safe project slug (e.g.,
fintech-sizzle).
- Name
brand- Type
- string
- Description
Brand identifier to associate with the project.
- Name
personality- Type
- string
- Description
Animation personality —
cinematic-dark,editorial,neutral-light, ormontage.
- Name
style_pack- Type
- string
- Description
Style pack —
prestige,energy,dramatic,minimal,intimate,corporate,kinetic, orfade.
- Name
date_prefix- Type
- boolean
- Description
Prepend
YYYY-MM-DDto the folder name. Default:true.
- Name
resolution- Type
- object
- Description
Output resolution as
{ w, h }. Default: 1920x1080.
- Name
fps- Type
- number
- Description
Frame rate. Default: 60.
- Name
duration_target_s- Type
- number
- Description
Target duration in seconds.
Returns: Project path, slug, and the created folder structure with a populated project.json.
Try asking your AI:
"Init a project titled 'Fintech Q2 Launch' with slug fintech-q2-launch, brand mercury, editorial personality, prestige style pack"
list_projects
List all projects in the workspace.
- Name
status- Type
- string
- Description
Filter by project status
- Name
limit- Type
- number
- Description
Max results (default: 20)
Returns: Array of project slugs with names, descriptions, and last modified timestamps.
Try asking your AI:
"What projects do I have?"
get_project
Get the full project.json plus resolved paths for an animation project.
- Name
project- Type
- string
- Description
Required. Project slug or path.
Returns: Project metadata (project.json contents) plus resolved paths for briefs, scenes, manifests, renders, and reviews.
Try asking your AI:
"Load the fintech-demo project"
get_project_context
Get the minimum useful working context for a project. Returns any combination of brief, storyboard, scenes, manifest, and review content — used by the autonomous direction pipeline.
- Name
project- Type
- string
- Description
Required. Project slug or path.
- Name
include- Type
- string[]
- Description
Which context sections to include — any of
brief,storyboard,scenes,manifest,review. Defaults to all.
Returns: The selected context sections (brief text, storyboard JSON, scene definitions, manifest, review output).
Try asking your AI:
"Get the brief and manifest context for the fintech-demo project"
save_project_artifact
Register or update an artifact in a project. Updates entrypoints and optionally writes metadata into project.json.
- Name
project- Type
- string
- Description
Required. Project slug.
- Name
kind- Type
- string
- Description
Required. Artifact type —
brief,storyboard,manifest,render,scene,version, orreview.
- Name
path- Type
- string
- Description
Required. Relative path within the project.
- Name
role- Type
- string
- Description
Entrypoint role to update (e.g.,
latest_render,approved_render).
- Name
scene_id- Type
- string
- Description
Scene ID (for
sceneartifacts).
- Name
version_id- Type
- string
- Description
Version ID (for
versionartifacts).
- Name
metadata- Type
- object
- Description
Additional metadata to store on the artifact.
Returns: The updated entrypoints and any metadata written to project.json.
Try asking your AI:
"Register renders/draft/hero.mp4 as the latest_render for product-launch"
render_project
Render a project manifest to video. Writes output to renders/ within the project. Runs the preflight doctor by default — encoder / font / plate / manifest / disk checks — and aborts on any fail-level check unless skip_preflight is true.
- Name
project- Type
- string
- Description
Required. Project slug.
- Name
manifest- Type
- string
- Description
Relative path to the manifest within the project. Defaults to
root_manifestfromproject.json.
- Name
output- Type
- string
- Description
Relative output path within the project. Default:
renders/draft/.
- Name
mark_as_latest- Type
- boolean
- Description
Update
entrypoints.latest_renderafter a successful render. Default:true.
- Name
skip_preflight- Type
- boolean
- Description
Skip the preflight doctor. Default:
false. Use when you know the environment is ready and want to bypass checks.
- Name
dry_run- Type
- boolean
- Description
Assemble render props and run preflight without spawning the render. Default:
false.
Returns: Render job status, preflight results, output file path, and encoding details.
Try asking your AI:
"Render the product-launch project"
"Dry-run the render for fintech-demo to check preflight"
preview_video
Launch a live preview in Remotion Studio. Point it at a render-props.json, a manifest.json, or a project directory and it opens the browser with the Sequence composition loaded, so you can scrub and inspect motion before committing to a full render. Local only — like render_project, this needs the Remotion runtime on your machine and is not available on the hosted surface.
- Name
input- Type
- string
- Description
Required. Path to render-props.json, manifest.json, or project directory
Returns: Confirmation that Remotion Studio launched, with the local preview URL.
Try asking your AI:
"Preview the latest render props for the fintech-demo project"
review_project
Run evaluation and critic tools on a project and store outputs in review/.
- Name
project- Type
- string
- Description
Required. Project slug.
- Name
manifest- Type
- string
- Description
Relative path to the manifest within the project. Defaults to
root_manifest.
Returns: Review artifacts written to review/ including evaluator findings, critic output, and summary report.
Try asking your AI:
"Run a review on the fintech-demo project"