{"id":"4166d708-6881-40c1-bd4a-9586c2b3814d","slug":"cutagent-sdk","kind":"skill","name":"cutagent-sdk","summary":"Connect AI agents to DaVinci Resolve Free and Studio. Open-source TypeScript SDK and local CLI.","owner":"jindratilk","repoUrl":"https://github.com/jindratilk/cutagent-sdk","license":"AGPL-3.0","licenseTier":"strong-copyleft","trust":"community","stars":3,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-09-08T14:41:16.000Z","addedAt":"2026-10-21T23:50:09.587Z","logoUrl":"https://avatars.githubusercontent.com/u/223098698?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools"],"tags":[],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-25T20:10:14.237Z","sample":false,"url":"https://conduits.dev/tools/cutagent-sdk","language":"Python","transports":["stdio"],"install":{"npm":"cutagent"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"<div align=\"center\">\n\n# 🎬 CutAgent SDK & CLI\n\n### Give your AI agent the keys to DaVinci Resolve.\n\nAn open-source connection between your agent and your editing timeline.<br>\n**Supports DaVinci Resolve 20+ Free and Studio on the currently qualified macOS setup; some operations require 21.1+.**\n\n[![AGPL-3.0 License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)\n[![DaVinci Resolve Free](https://img.shields.io/badge/DaVinci_Resolve-Free_%26_Studio-ff5a2b)](#-yes-it-works-with-davinci-resolve-free)\n[![TypeScript](https://img.shields.io/badge/TypeScript-SDK-3178C6)](sdk/README.md)\n\n[Get started](#-get-started) · [Agent Skills](#-agent-skills) · [Examples](examples/) · [Documentation](docs/GETTING_STARTED.md)\n\n</div>\n\n---\n\n## From an idea to an editable timeline\n\nYour agent can write code. Now give it a way to work with your footage.\n\nCutAgent SDK lets agents and scripts organize media, build timelines, edit clips, work with audio, create Fusion graphics, and export videos in DaVinci Resolve. The work stays in your project, where you can inspect it, change it, and keep editing.\n\nUse the TypeScript SDK for editing scripts, or CutAgent CLI when your agent works through a terminal. Bring an agent that can run local code and give it the SDK documentation and examples to work from.\n\n## ✨ What you can create\n\n| Your next project | What the SDK brings |\n| --- | --- |\n| A real estate reel | Arrange shots, adjust framing, shape the pacing, and add titles. |\n| A podcast edit | Organize cameras and audio, work with multicam cuts, and add captions. |\n| A repeatable content workflow | Import files, organize bins, apply edits to multiple clips, and export. |\n| Your own motion graphics | Build editable Fusion text, node graphs, and keyframe animations. |\n| A custom editing assistant | Read the current timeline and let your agent make changes through code. |\n\nYour agent supplies the editing decisions and scripts for these workflows. The SDK connects them to DaVinci Resolve.\n\n## 🆓 Yes, it works with DaVinci Resolve Free\n\nYou don't need to buy DaVinci Resolve Studio to get started.\n\nCutAgent SDK includes a local script that connects to the free edition. Install it, open it from **Workspace → Scripts → CutAgentSDK**, and your agent can work with your project.\n\nDaVinci Resolve Studio is supported too. Studio-only features require a DaVinci Resolve Studio license.\n\n**Current platform: macOS.** Windows setup is not available yet. Free and Studio have passed native marker tests on earlier releases; the latest Studio source has also passed a marker create/read/delete test. See [current verification and limitations](RELEASE_STATUS.md) for what has been tested.\n\n## 🛠️ Beyond the scripting API\n\nCutAgent SDK & CLI extends the DaVinci Resolve scripting API with additional editing controls and workflows.\n\n- **Animate directly on the timeline.** Add, inspect, update, and delete clip keyframes, with control over interpolation.\n- **Shape your speed ramps.** Create variable-speed changes with explicit timing and interpolation, beyond a single playback-speed setting.\n- **Go deeper into the Color page.** Adjust primary grades, custom and hue curves, HDR controls, qualifiers, Power Windows, Color Warper pins, and color-space transforms.\n- **Shape your color node graph.** Create serial, parallel, and layer structures, configure layer blending, and connect alpha outputs.\n- **Take control of Fairlight.** Work with track EQ, dynamics, and audio automation beyond the API’s clip-level audio properties.\n- **Shape your audio fades.** Adjust fade-in and fade-out curves independently using their control points.\n- **Make precise timeline edits.** Split and trim existing clips, and remove through edits.\n- **Direct your multicam edit.** Define angle names, order, source offsets, and exact switching points. Restructure angles, replace sources, and create repeatable podcast cutting plans.\n\n## ⚡ Faster and cheaper\n\nTwo ways in: write TypeScript with the SDK, or run commands with the CLI.\n\n- **Turn code into a timeline.** Let your agent express an editing workflow as code, using variables, loops, and reusable functions.\n- **Run multi-step editing scripts.** Your agent can combine several editing operations in a single script execution.\n- **Keep more context for the edit.** Use SDK code or CLI commands without loading a large catalog of individual editing tools into your agent’s context.\n- **Spend fewer tokens on orchestration.** Code-driven workflows can reduce model round trips and repeated tool-call overhead, leaving more room for your footage, instructions, and creative decisions.\n- **Use whichever fits.** Reach for the CLI for a quick operation, or the SDK for a reusable editing workflow.\n\n## 🤖 Built for agents. Useful for people.\n\n- **Bring your own agent.** Use a coding agent that can run local commands and TypeScript scripts.\n- **Keep editing in DaVinci Resolve.** Work with timelines, clips, audio, and Fusion compositions in the editor you already use.\n- **Work locally.** Run editing scripts on your computer, directly in DaVinci Resolve.\n\nBring your own AI model. CutAgent SDK supplies the local editing connection, and the optional skills below help the agent use it. Your agent provider handles its own data policies and billing.\n\n## 🧠 Agent Skills\n\nThe [35 public Agent Skills](skills/) help coding agents plan and verify local DaVinci Resolve work. `cutagent` routes to focused SDK, CutAgent CLI, editing, Fusion, audio, captions, color, multicam, rendering, and creative skills. Each skill follows the standard `SKILL.md` format with optional on-demand references and assets. The [creative skill review](docs/CREATIVE_SKILLS_REVIEW.md) records how all 22 original workflow concepts were adapted for standalone use.\n\nInstall the skills in a supported coding agent with:\n\n```sh\nnpx skills add jindratilk/cutagent-sdk\n```\n\nThis installs instructions, not the CutAgent runtime. Build and install the package below, then connect it to DaVinci Resolve. The public skills use local SDK/CLI operations and supplied or locally licensed media; they do not require a CutAgent account or hosted service. For exact API and command syntax, agents should inspect the installed package and live capabilities.\n\n## 🚀 Get started\n\nYou'll need macOS, DaVinci Resolve, Node.js 22.12+ or 24.x, and Python 3.12. Install FFmpeg and FFprobe for media inspection and export workflows.\n\nInstall the SDK from source:\n\n```sh\ngit clone https://github.com/jindratilk/cutagent-sdk.git\ncd cutagent-sdk\nnpm ci --ignore-scripts\nnpm run build\nnpm pack\nmkdir ../my-video-project\ncd ../my-video-project\nnpm init -y\nnpm install ../cutagent-sdk/cutagent-3.1.0.tgz\n```\n\n**Using DaVinci Resolve Free?**\n\n```sh\nnpx cutagent setup --free\n```\n\nStart the local runtime first (it starts the Free broker when needed):\n\n```sh\ncutagent runtime start --transport embedded_free\n```\n\nKeep the runtime running, then open **Workspace → Scripts → CutAgentSDK** in DaVinci Resolve. Confirm the actual connection with `cutagent --json status`: `data.status` must be `connected` and `data.resolve` must be `true`. Runtime readiness alone does not prove a DaVinci Resolve connection.\n\n**Using DaVinci Resolve Studio?** Set external scripting to **Local**, then run:\n\n```sh\nnpx cutagent setup\ncutagent runtime start --transport studio_external\n```\n\nKeep that terminal running. It prints the connection-file path; set `CUTAGENT_SDK_DISCOVERY_FILE` to that path in the terminal where your agent or script runs.\n\n[Full setup guide →](docs/GETTING_STARTED.md)\n\n## Your first connection\n\n```ts\nimport { CutAgent } from \"cutagent\";\n\nconst client = await CutAgent.connect();\n\ntry {\n  const project = await client.projects.current();\n  const timeline = await project.timelines.current();\n\n  console.log(`Ready to edit ${timeline.name} in ${project.name}`);\n  console.log(await timeline.snapshot());\n} finally {\n  await client.close();\n}\n```\n\nStart with the [examples](examples/), including a marker workflow that creates a temporary marker, reads it back, and removes it again.\n\nThe standalone package and skills above are sufficient for local agent workflows; no CutAgent desktop app is required.\n\n## Help make it better\n\nFound a bug? [Open an issue](https://github.com/jindratilk/cutagent-sdk/issues) with your operating system, DaVinci Resolve version and edition, and a small script that reproduces it. Leave out credentials and private footage.\n\nPull requests are welcome. Run the build, tests, and source checks before submitting a change. If this project is useful to you, a star helps other editors and builders find it. ⭐\n\n## License\n\n[GNU AGPL-3.0](LICENSE). Third-party components keep their [own licenses](THIRD_PARTY_NOTICES/README.md).\n\nDaVinci Resolve is a product of Blackmagic Design Pty Ltd. This project is independent and is not affiliated with or endorsed by Blackmagic Design.\n"}