Docs

Install the FrameJam plugin

FrameJam is a plugin for Claude, ChatGPT and Cursor. Paste one line into your agent. It does the rest.

Before you start

  • Node 22 or later.
  • ffmpeg, for frame thumbnails and rendering.

FrameJam reviews videos from any tool. Hyperframes is the default for building, and the styles are Hyperframes templates. You always review the rendered video.

The easy way: ask your agent

Paste the prompt for your app. Your agent runs framejam install, which installs the FrameJam plugin (the tools and the skill), checks Node and ffmpeg, starts FrameJam and prints the link to open.

Claude Code or the Claude app

Run `npx -y framejam install claude` and open the link it prints in your built-in browser.

ChatGPT (Work or Codex)

Run `npx -y framejam install codex` and open the link it prints in your built-in browser.

Cursor

Run `npx -y framejam install cursor` and open the link it prints in your built-in browser.

Then start a new session in Claude, reopen the ChatGPT app, or reload the Cursor window, so the plugin loads. FrameJam shows up in the app's plugin list, where you can turn it off or remove it. Type /framejam:start to begin.

Other agent apps

Windsurf, VS Code, Gemini CLI, OpenCode, Cline, Zed and any other app that runs on your computer and supports MCP. Your agent sets itself up:

Install FrameJam for me: add a local MCP server named "framejam" to your MCP settings (command "npx", args ["-y","framejam","--stdio"]), install the FrameJam skill with `npx -y skills add moritzkremb/framejam -g -y`, then run `npx -y framejam start` and open the link it prints in your built-in browser.

Or run it yourself

npx -y framejam install

Without an app name it sets up every app it finds: Claude Code, ChatGPT and Cursor. Name one or more to pick, for example npx -y framejam install cursor claude.

Manual setup

This is what the install command does, then start FrameJam with npx -y framejam start.

Claude Code and the Claude app

In Claude Code:

/plugin install framejam --marketplace moritzkremb/framejam

Or in a terminal:

claude plugin marketplace add moritzkremb/framejam claude plugin install framejam@framejam

In the Claude app you can also go to Customize → Plugins → Add → Add marketplace → Add from a repository, and enter moritzkremb/framejam.

ChatGPT (Work and Codex)

codex plugin marketplace add moritzkremb/framejam codex plugin add framejam@framejam

The codex command comes with the ChatGPT desktop app. Reopen the app; FrameJam is listed under Plugins.

Cursor

Cursor also loads plugins you installed in Claude Code, so if you have FrameJam there, you're done. Otherwise copy the plugin folder to ~/.cursor/plugins/local/framejam and reload the window.

Without the plugin

For other agents: add the MCP server and the skill. In Cursor that's ~/.cursor/mcp.json:

{ "mcpServers": { "framejam": { "command": "npx", "args": ["-y", "framejam", "--stdio"] } } }

Claude Code:

claude mcp add -s user framejam -- npx -y framejam --stdio

Codex:

codex mcp add framejam -- npx -y framejam --stdio

The skill (use your app's name after -a):

npx -y skills add moritzkremb/framejam -g -a cursor -y

Running a local build? Replace npx -y framejam with:

node /absolute/path/to/framejam/dist/server/cli.js --stdio

Tools not showing up? Restart your agent app. Server won't start? Use the full path from which npx as the command.

Other MCP clients

Run npx -y framejam and connect to http://localhost:2400/mcp over streamable HTTP.

What the skill does

Every agent gets short instructions when it connects. The skill (/framejam:start in the plugin) teaches the full loop: pick a style, build, render, open_review, wait_for_feedback, edit, add_version. The plugin also adds /framejam:playbook and /framejam:style to pick on a page.

Make your first video

  1. Ask your agent:
    Make a 7-second launch teaser with FrameJam and open it for review.
  2. To use a look or a method, name a style or playbook in your request — a product launch video or a vertical short — or type /framejam:style to choose on a page. The Claude video guide shows the first edit end to end.
  3. Open the review link it shares, add comments and press Finish review. Version 2 arrives in the same tab.

Configuration

SettingFlagEnvironmentDefault
Port--portFRAMEJAM_PORT2400
Bind address--hostFRAMEJAM_HOST127.0.0.1
Data folder--data-dirFRAMEJAM_HOME~/.framejam
Base URL in linksFRAMEJAM_PUBLIC_URLhttp://localhost:<port>
Update noticeFRAMEJAM_NO_UPDATE_CHECKunset. Set to 1 to stop looking for a newer version on npm.

Command line

Your agent app starts FrameJam for you. You only need these to run it by hand.

CommandWhat it does
npx -y framejam install [app…]Installs the FrameJam plugin for claude, codex (ChatGPT) and/or cursor (every app it finds if you name none) and starts the web UI. Safe to run again.
npx -y framejamStarts the web UI and MCP over HTTP. Same as framejam serve.
npx -y framejam startStarts FrameJam and prints the URL to open.
npx -y framejam --stdioMCP over stdio, for agent apps. Also hosts the web UI if port 2400 is free. Same as framejam mcp.
npx -y framejam --helpLists the options.

Update

In Claude, the plugin updates on its own. The Projects page shows a notice when a newer version is on npm; to update everywhere, run npx -y framejam@latest install. It updates the plugin and replaces an older FrameJam that is still running in the background. Then restart your agent app so it loads the new version. FrameJam checks npm at most every 6 hours; set FRAMEJAM_NO_UPDATE_CHECK=1 to turn that off.

Uninstall

  1. Remove the plugin from your app's plugin list. Or: Claude claude plugin uninstall framejam@framejam, ChatGPT codex plugin remove framejam@framejam, Cursor delete ~/.cursor/plugins/local/framejam.
  2. Optional: delete ~/.framejam. That removes every review, version, comment and style you made.

Next: the MCP tools reference, or Troubleshooting if something doesn't work.

How to edit videos with Claude, How to make videos with Claude walks through it step by step, with a video. More in Guides.