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 installWithout 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/framejamOr in a terminal:
claude plugin marketplace add moritzkremb/framejam
claude plugin install framejam@framejamIn 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@framejamThe 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 --stdioCodex:
codex mcp add framejam -- npx -y framejam --stdioThe skill (use your app's name after -a):
npx -y skills add moritzkremb/framejam -g -a cursor -yRunning a local build? Replace npx -y framejam with:
node /absolute/path/to/framejam/dist/server/cli.js --stdioTools 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
- Ask your agent:
Make a 7-second launch teaser with FrameJam and open it for review. - 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:styleto choose on a page. The Claude video guide shows the first edit end to end. - Open the review link it shares, add comments and press Finish review. Version 2 arrives in the same tab.
Configuration
| Setting | Flag | Environment | Default |
|---|---|---|---|
| Port | --port | FRAMEJAM_PORT | 2400 |
| Bind address | --host | FRAMEJAM_HOST | 127.0.0.1 |
| Data folder | --data-dir | FRAMEJAM_HOME | ~/.framejam |
| Base URL in links | FRAMEJAM_PUBLIC_URL | http://localhost:<port> | |
| Update notice | FRAMEJAM_NO_UPDATE_CHECK | unset. 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.
| Command | What 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 framejam | Starts the web UI and MCP over HTTP. Same as framejam serve. |
npx -y framejam start | Starts FrameJam and prints the URL to open. |
npx -y framejam --stdio | MCP over stdio, for agent apps. Also hosts the web UI if port 2400 is free. Same as framejam mcp. |
npx -y framejam --help | Lists 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
- Remove the plugin from your app's plugin list. Or: Claude
claude plugin uninstall framejam@framejam, ChatGPTcodex plugin remove framejam@framejam, Cursor delete~/.cursor/plugins/local/framejam. - 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.