# splice

> A video-editing CLI for AI agents: one JSON document in, ffmpeg out.

- [Introduction](https://splice.gramcartlabs.tech/index.md): A video-editing CLI for AI agents and for anyone who would rather edit a document than a filter graph.
- [Quickstart](https://splice.gramcartlabs.tech/quickstart.md): Install, create a project, make three edits, render a file, and look at it.
- [Install and ffmpeg](https://splice.gramcartlabs.tech/guides/installation.md): What `npm install` gives you, why ffmpeg is required, and how to fix a build that cannot draw captions.
- [Editing](https://splice.gramcartlabs.tech/guides/editing.md): Trim, retime, reorder, ramps, and removing fillers or long silences.
- [Layers, camera, masks](https://splice.gramcartlabs.tech/guides/layers.md): How the z-ordered stack composites, what the bottom layer means, and how placement, camera keys and masks differ.
- [Captions and transcription](https://splice.gramcartlabs.tech/guides/captions.md): Turn a recording into an SRT, review it, then decide separately whether to burn it in.
- [Rendering and caching](https://splice.gramcartlabs.tech/guides/rendering.md): What a render compiles to, how the cache decides, preview versus final, loudness, and prunes.
- [For agents](https://splice.gramcartlabs.tech/guides/agents.md): The loop, the JSON contract, and the mistakes that cost the most tokens.
- [Command reference](https://splice.gramcartlabs.tech/reference/cli.md): Every verb, its flags, and what it prints.
- [Project file](https://splice.gramcartlabs.tech/reference/project-file.md): splice.json version 2: canvas, layers, overlays, audio, captions, grade — and the invariants that make a file invalid.
- [Errors and warnings](https://splice.gramcartlabs.tech/reference/errors.md): Every code with its exit status, cause and fix, plus the warnings worth acting on.
- [How it works](https://splice.gramcartlabs.tech/reference/how-it-works.md): The pipeline, why compositing is its own step, and how the pieces are tested.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.