AgentFX

Motion graphics and video effects for AI agents. A native CPU/GPU renderer, no browser.

An agent such as Claude Code, Codex or any MCP client writes a short script in Reel Script (.reel). AgentFX lints it with fix hints, shows single frames and contact sheets so the agent can look before it renders, and renders the video with its own Rust renderer. Output is exactly what the script says (copy, brand colours, timing), and the same script always gives the same frames.

Website: agentfx.dev · Videos: YouTube @agentfxdev · Trailer: watch on YouTube

Nine lines, one clip

This is the whole script for the clip above (examples/quickstart.reel):

video "Hello AgentFX" size=1280x720 fps=30 captions=off
scene ink dur=4s
  layer #film x=0 y=0 w=100% h=100%
    fluid #ink res=1/4 vorticity=18 seed=3 color=#3CBF87
    text #word "AGENTFX" size=200 weight=900 color=#3CBF87 x=50% y=50% anchor=center nowrap
      when portrait
        set #word size=110
  @1s ink #word into #ink dur=0.5s noise=400
  @1.4s stir #ink at=50%,50% radius=30% strength=3 dur=1.4s

Try it with Docker (no build)

The image contains the CLI, the renderer, ffmpeg and the MCP server. GPU effects fall back to the CPU path inside the container.

docker run --rm -v "$PWD:/work" ghcr.io/agentfxhq/agentfx render examples/quickstart.reel -o hello.mp4 --no-tts

Add it to Claude Code as an MCP server, with the current folder as the working folder:

claude mcp add agentfx -- docker run -i --rm -v "$PWD:/work" --entrypoint python3 \
  ghcr.io/agentfxhq/agentfx /usr/local/share/agentfx/mcp/server.py

Quick start (Linux)

You need Rust stable (1.91 or newer) and ffmpeg. Optional: Vulkan on Linux or Metal on macOS for GPU effects, and piper for text to speech.

git clone https://github.com/agentfxhq/agentfx && cd agentfx
tools/install.sh        # builds, installs agentfx + agentfx-render to ~/.local/bin, data to ~/.local/share/agentfx

Or build in place with cargo build --release (binaries in target/release/). Details and all environment variables: docs/BUILD.md.

Copy the nine-line script above to hello.reel (or use examples/quickstart.reel), then lint, look, render:

agentfx lint hello.reel --measure --all-formats   # JSON diagnostics, checked in 16:9 and 9:16
agentfx frame hello.reel --at 2.2s -o frame.png   # one frame, to look at
agentfx sheet hello.reel -o sheet.png             # a contact sheet of the whole video
agentfx storyboard hello.reel -o board.png        # a hand-drawn storyboard: a sketch per shot, arrows, notes
agentfx render hello.reel -o hello.mp4            # the video (.gif, .webp, .mov, .webm by extension)
agentfx render hello.reel --format 9:16 -o hello-vertical.mp4

agentfx catalog --md lists everything the format can do; docs/SPEC.md is the full Reel Script reference. More examples: examples/features/ (one effect per file), examples/showcase.reel, examples/components.reel.

Use with Claude Code, Codex and MCP

Claude Code plugin (skill + MCP server in one step, needs Docker):

/plugin marketplace add agentfxhq/agentfx
/plugin install agentfx@agentfx

Skill. skill/agentfx/ is an agent skill: quick mode (write, lint, look, render) by default, and an optional director mode that agrees on brief, directions, dramaturgy, storyboard and hero variants before the full render. For Claude Code, copy or link the folder into ~/.claude/skills/agentfx/; other agents can read SKILL.md as instructions.

MCP server. mcp/server.py (Python standard library only) exposes agentfx_spec, agentfx_catalog, agentfx_lint, agentfx_timing, agentfx_frame, agentfx_sheet, agentfx_render, agentfx_design_guide, agentfx_lens and an optional agentfx_critique. Frames and sheets come back as images, so the agent can look at its work.

claude mcp add agentfx -- python3 /path/to/agentfx/mcp/server.py
# after tools/install.sh:
claude mcp add agentfx -- python3 ~/.local/share/agentfx/mcp/server.py

Any MCP client that speaks stdio works the same way (for Codex, add the same command as an MCP server in its config). Without MCP, agents simply call the agentfx CLI: every command prints JSON.

Director desk (optional). director/ holds a small local web page and a second MCP server for director mode: the agent posts decision cards, you answer them in the browser. It binds to 127.0.0.1 only and has no authentication. See skill/agentfx/desk.md.

Effects

• Fluid and ink: a 2D fluid solver: pour, stir, dissolve a word into ink, reveal a layout through a stain.
• Physics: drop, pile, push and swing; rigid bodies solved at compile time and baked into keyframes.
• Shatter: Voronoi fracture for text, logos and shapes, driven by the same physics.
• Slit-scan and time displacement, time remap, rewind, echo: effects that need the frames before and after.
• Infinite zoom: seamless loops with nested worlds and a constant-speed camera.
• Glitch, RGB split, VHS and CRT, dither, ASCII: seeded looks, animatable per layer.
• Halftone, risograph, grain, colour grading and LUTs.
• Light on flat design: soft shadows from distance fields, light sweeps, god rays.
• Kinetic typography: per letter, word or line animators, variable font axes, OpenType features, strokes, text on a path.
• Audio: beat and bar anchors, properties driven by the music, spectrum and waveform visualizers.
• Captions: word-by-word styles from SRT, VTT or Whisper JSON, with safe-area and read-time lint.
• Presenter: a rigged character with lip sync, gestures and moods.
• Point clouds and world camera: tens of thousands of particles, camera tours over one large canvas.
• Layout and components: cards, stats, charts, diagrams, code with diffs, browser and phone mockups, a 2.5D camera.
• Stylised 3D: extruded letter blocks, boxes, stages and screens that show any 2D layer, toon shading with outlines, emissive glow, fog and ground shadows; orbit, dolly, truck and look-at camera moves, spin, drop, assemble and stack verbs (examples/features/3d.reel).
• Motion blur (shutter-accurate), masks and mattes, blend modes.

Output: MP4 (H.264 via x264, VAAPI/QSV, NVENC or macOS VideoToolbox), ProRes 4444 and VP9 with alpha, GIF, animated WebP, PNG sequences; 16:9, 9:16, 1:1 and 4:5 from one script.

Status and limits

AgentFX is early software (0.1.0). Expect the format and the CLI to change.

• Platforms: tested on Linux (x86_64). macOS has an on-demand CI build and CPU-test job; its Metal GPU and VideoToolbox paths require macOS hardware CI coverage. Windows (x86_64, MSVC) has an experimental on-demand CI build and CPU-test job; see docs/BUILD.md#windows.
• GPU: GPU effects use Vulkan on Linux, Metal on macOS, and DX12 or Vulkan on Windows (via wgpu). Without a usable GPU (common in containers, CI, and WSL) everything renders on the CPU automatically. Set AGENTFX_GPU=0 to skip the GPU probe. See docs/BUILD.md for details.
• Stylised 3D, not photoreal: scene3d renders boxes, spheres, cylinders, tori, extruded text and SVG paths, OBJ meshes and screens showing 2D layers, with flat/lambert/toon/phong shading, outlines, glow, fog and planar ground shadows, on the CPU. No PBR or global illumination, no shadow maps, no glTF, no GPU path yet.
• No timeline editor: the script is the source of truth.
• Text to speech: piper (local) is the default. The edge engine uses an undocumented online service and is opt-in only; see docs/INSTALL-NOTES.md.
• Music: bring your own track; AgentFX analyses it for beats but does not compose.
• HTML input: the renderer also takes HTML/CSS scenes with CSS animations (docs/INPUT.md); full CSS and JavaScript are not supported.

Repository layout

Path	What
crates/ir	agentfx-ir: the intermediate representation (docs/IR.md)
crates/render	agentfx-render: the renderer (IR or HTML scene to video)
crates/script	agentfx: the Reel Script compiler and main CLI
vendor/	patched Blitz, Parley and Stylo crates (vendor/README.md)
assets/, design/	bundled fonts (OFL), design lenses and component skins
examples/	Reel Script examples, IR and HTML samples
docs/	spec, IR and input formats, build notes
tools/, mcp/, skill/, director/	helper scripts, MCP server, agent skill, director desk

Licence

Apache License 2.0, see LICENSE. Copyright 2026 Levels Branding and Webdevelopment OG. Third-party code and fonts keep their own licences (MIT/Apache-2.0, MPL-2.0 for the vendored Stylo, OFL-1.1 for the fonts); see NOTICE.

Security issues: see SECURITY.md. Contributions: CONTRIBUTING.md.