Motion Minds

Make videos with your AI agent. Every version tracked.

An open-source agent skill, CLI and local Studio for making HyperFrames videos with the AI coding agent you already use.

Website · Repository · Documentation · npm · Report an issue

_{30-second walkthrough, made with MotionMind itself.}

AI agents can already write a motion graphic. What goes wrong is everything around it: the agent skips straight to code, a "small change" overwrites the version the client approved, nobody knows which render was the good one, the audio sits at a random level, and the next chat starts from zero.

MotionMind gives the agent a production process and gives you a record of it. The agent works like a studio (concepts, storyboard, build, review, render) and stops for your approval at each step. Every render becomes a frozen, measured version that you can compare, edit without code in HyperFrames Studio, and promote to production.

One npm package, motionmind, with four parts. The agent uses all of them, and so can you.

Every version is a HyperFrames project (HTML + GSAP) rendered to an H.264 MP4, so it can be reopened, edited visually and re-rendered identically later. Already working in HyperFrames Studio, Premiere or CapCut? motionmind track logs every render or export as a version.

1. Brief, then pick a concept. Describe the product, format, length and call to action. The agent writes two or three genuinely different concepts, and you pick one.
2. Approve the storyboard. A per-second table, with the style locked in TASTE.md (palette, type, easing, music) so later versions look and move the same.
3. The agent builds and renders. One scene per file. The agent runs HyperFrames check and snapshot after every change and looks at the frames itself.
4. Review and promote. Watch it in the Studio or edit it in HyperFrames Studio. After QA (−14 LUFS, true peak ≤ −1 dBFS, phone safe area), promote it to production. The previous production version is archived, never deleted.

Requirements: Node.js 22+, ffmpeg and ffprobe on PATH, and an agent CLI. HyperFrames and its headless Chrome are fetched on first use.

npm i -g motionmind
motionmind setup my-studio   # workspace + the motionmind skill + the official HyperFrames skills
cd my-studio
motionmind doctor            # checks Node, ffmpeg, Chrome, HyperFrames, the skill and your agent CLI
motionmind ui                # Studio at http://127.0.0.1:4310

Then, in a second terminal in the same folder, start your agent and brief it:

Use the motionmind skill. I want a 15-second 9:16 promo for my coffee shop "Kopi Senja",
message "great coffee, friendly prices", CTA kopisenja.id, music + SFX, no voice-over.

• Content creators: promos and reels with text inside the phone safe area and audio at a measured level.
• Agencies and marketing teams: the version the client approved is never overwritten. Compare v1 and v2, then promote the one that wins.
• Developers and AI agent users: the skill is a plain Agent Skills folder and the CLI works from any agent, with whichever model you prefer.
• Video editors: keep your own editor and let MotionMind keep the record.

• Bugs and feature requests: open an issue.
• Security problems: please don't open a public issue. Report them privately via Security → Report a vulnerability on motionmind-video.

MotionMind is MIT licensed. The MotionMind name and logo are not covered by the MIT licence.

HyperFrames and HeyGen are trademarks of HeyGen. MotionMind is not affiliated with HeyGen. HyperFrames is licensed under Apache 2.0.