Cinecode: An Open-Source Toolkit for Making Videos with AI Coding Agents
Cinecode uses AI coding agents to build video scenes, design sound, and export an MP4. Here is how its production modes, setup, and editable source files work.

Cinecode is an open-source toolkit that lets AI coding agents produce short films, product videos, and explainers. Developed by sarpstar, it runs through tools such as Claude Code and Cursor, taking a written brief through scripting, scene construction, sound design, and MP4 export.
Scenes are built with Canvas 2D or three.js, with timing, camera movement, text, and transitions defined in code. Users retain the source behind the video, allowing individual elements to be revised after the first render.
The repository includes demonstrations of animated shorts, advertisements, explainers, and a five-minute documentary. These are examples published by the project; results will depend on the brief, rendering environment, and revisions required. Official repository
PART 01 | Tool overview
Cinecode contains production instructions, reference material, starter files, and utilities. The coding agent reads these resources and uses local tools to build the film.
The process starts with an idea, a duration, and a format. Users can supply product screenshots, logos, reference images, footage, or music. Before building the complete film, the agent presents a plan and still frames from two scenes. A low-resolution draft follows for reviewing movement, pacing, text, and sound.
Two production modes are available. Quick mode builds the film around a self-contained film.html file, using Canvas 2D or three.js/WebGL with Web Audio. Film mode follows a more detailed sequence of roadmap, script, style frames, animatic, and shot rendering. A Quick-mode project can also be developed further in Film mode. Workflow documentation
PART 02 | Core features
Editable scenes and timing
Scenes are defined as functions of time. Camera positions, object movement, captions, and transitions can be adjusted in the underlying code. In a product video, this could mean extending an interface demonstration or holding the closing frame for longer. Changes still require rendering and review.
Visual styles and references
The kit includes eight style families, ranging from cinematic rendering and anime to paper collage, retro graphics, and ink. Reference images placed in a refs/ directory can help establish palette, lighting, and composition. The presets provide a starting direction; the final appearance depends on the scene implementation.
Sound and narration
Cinecode includes guidance and tools for ambience, effects, narration, and music. Audio cues can follow visual events, and narration can be processed to suit the film. Speech options include external services and supported local models, with different language and hardware requirements.
Reusable formats
A film’s format can be saved for later episodes. Recurring explainers or product updates can retain typography, colours, framing, and transitions while changing the content. New scripts may still require adjustments to pacing and layout.
PART 03 | Getting started
The documented requirements include Node.js 22 or later, Python 3.9 or later, ffmpeg, and Chrome or a compatible browser, with a GPU accessible to the browser.
In Claude Code, users can request installation directly:
Install the cinecode skill from https://github.com/sarpstar/cinecode.
The equivalent manual command is:
git clone https://github.com/sarpstar/cinecode.git ~/.claude/skills/cinecode
Cursor uses ~/.cursor/skills/cinecode as the documented installation directory. After installation, start a new conversation in an empty project folder and describe the video. Installation instructions
A brief can be as simple as:
Make a 15-second product video using the supplied screenshots and logo. Use Quick mode, a 16:9 frame, and simple interface animation. End with the product name and website.
PART 04 | Output files and practical use
The finished MP4 can be published as a standalone video or imported into an editor for further work. Retaining the project directory preserves the source code and supporting assets needed for later revisions. In Quick mode, film.html contains the central scene and audio implementation.
The workflow is relevant to interface demonstrations, animated diagrams, and recurring video formats. More complex subjects, such as detailed character performances or natural movement, require closer evaluation of what the agent can construct with the available tools and assets.
Cinecode is released under the MIT licence. Running it may still involve coding-agent fees, optional speech services, and local rendering costs. External models, music, fonts, and other assets retain their own licensing terms.
Related reading: Video-based motion capture with Motion2MixamoRig.
Project: Cinecode on GitHub
ings
