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.

This is the beginning of the README. Read the rest at the original. Read the full README ↗