Agent Storyboard plugin
A Codex and Claude Code plugin with a local storyboard table: the agent writes shots and makes images, motion and voice-over
- 396 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The plugin runs a local web service, calls Codex, ffmpeg and Whisper and writes project files to disk.
- Lines and voice samples are sent to the online VoxCPM service.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/agent-storyboardDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The plugin runs a local web service, calls Codex, ffmpeg and Whisper and writes project files to disk.
- Lines and voice samples are sent to the online VoxCPM service.
This is third-party code. Review the repository files before installing.
What it does
Agent Storyboard puts short video prep into one table on your computer. Through MCP the agent creates a whole project: shots, lines, frame descriptions, type and duration. It does not drive a browser and never edits data files directly. The agent processes shots marked for generation in turn and places each result in the right row. Codex draws images with its built-in generator, while Claude Code calls a local Codex for that. Motion inserts render through HyperFrames or Remotion, and your own photos and clips can be uploaded by hand. Voice-over comes from the online VoxCPM service from a voice description or a sample recording, then a local Whisper aligns it to the lines and sets shot durations. The plugin also has 12 visual styles with a `DESIGN.md` file, a cover workshop and export to Markdown, HTML, Word and plain text.
Who it is for. Short video creators for Douyin, TikTok and Reels who keep script, frames and voice-over in separate tools and lose track between them.
Good fit when
- You have a video topic, and the agent should write shots with lines and frame descriptions in 9:16 right away.
- Images for a dozen shots must be generated in a batch without sorting files by hand.
- The voice-over is ready, and each shot's duration should match the lines automatically.
- A director wants to check the pacing shot by shot in full screen before editing.
Not a fit when
- You need the actual edit of a finished video with transitions and colour.
- Voice-over must not go to an external online service.
- You work in Cursor or another agent without Codex and Claude Code plugin support.
Example request
Create a 9:16 storyboard project about turning my rented flat into a studio: fast pace, clean style, with lines and frame descriptions.Limitations
You need Node.js 18 or newer and Codex or Claude Code; Python is not required. In Claude Code images are made through a locally installed Codex, and without it the agent's own tools or manual upload remain. Voice-over goes through the online VoxCPM service and needs network access, ffmpeg handles transcoding and Whisper aligns audio to lines. Clone a voice from a sample only with your own recording or the voice owner's consent. The documentation is in Chinese.
How to disable. In Claude Code remove the `agent-storyboard@agent-storyboard` plugin; in Codex remove it with the plugin manager. Projects live in the folder set by `AGENT_STORYBOARD_DATA_DIR`.
FAQ
How do I install Agent Storyboard in Claude Code?
Run `claude plugin marketplace add Yuuhann1999/agent-storyboard` and `claude plugin install agent-storyboard@agent-storyboard`. Then open a new chat and check in `/mcp` that the server is connected.
Where does the storyboard table open?
The plugin starts a local web service and gives a link, `http://127.0.0.1:43218` by default. The `AGENT_STORYBOARD_PORT` variable changes the port.
How does Claude Code make images without a generator?
The `generate_storyboard_image` tool calls the Codex installed on your computer. It takes the task, draws the image, checks it and places it in the right shot.
Which aspect ratios are supported?
`9:16`, `16:9`, `3:4`, `4:3` and `1:1`. Covers are kept separately for vertical and horizontal versions.
What happens without Whisper?
Voice-over is still generated; only automatic alignment to lines is lost. Install Whisper with `brew install whisper-cpp`.
Discussion
No questions or reviews yet.
Related
PluginsA skill for Claude Code and Codex: the agent writes animation scenes, a browser player shows them, export to MP4 and Lottie.
Skills, a CLI and an MCP server that let Claude Code or Codex make video from a brief: editing, graphics, voiceover, subtitles
ChatCut connects Claude Code, Codex and Cursor to a video editor: the agent edits your footage, adds captions, cuts silences.
A video editing skill for Claude Code and Codex: the agent cuts pauses and filler words, grades color, burns subtitles and adds animated overlays
A local short-video studio: topic, script, CC0 images, voice-over and MP4 with subtitles, driven by Claude Code or Codex
A workspace for talking-head video editing: an agent cuts flubs, adds subtitles, cards and sound while you refine in a browser.
README in short
The Chinese README explains why script, frames and voice-over belong in one place and gives installation for Codex and Claude Code. Then come a workflow diagram, a feature tour with screenshots, dependencies, environment variables and a table of MCP tools.