manage-storyboard-projects

name	manage-storyboard-projects
description	Create, find, inspect, update, or delete Codex Storyboard projects directly through MCP. Use when the user asks Codex to write a new video script or storyboard into the local storyboard app, add or revise shots, rename a project, change its aspect ratio, find an existing project, or delete one without browser automation.

Manage Storyboard Projects

Use the Codex Storyboard MCP project tools. Never control the browser, never run npm start manually during normal use, and never edit data files directly.

If the current Codex session does not expose Storyboard MCP tools such as create_storyboard_project, list_storyboard_projects, or open_storyboard, first use tool_search to search for codex storyboard and load the deferred tools. Only if tool_search is unavailable or cannot find them, tell the user to start a new Codex conversation or restart Codex so plugin tools are reloaded. Do not silently fall back to editing local data files directly.

Open the storyboard

If the user asks to open, start, launch, or show Codex Storyboard:

1. Call open_storyboard.
2. Return the local URL as a clickable link.
3. Tell the user to open the link in the Codex side panel.
4. Do not launch Chrome, shell open, Computer Use, or Browser automation just to open the page.

The plugin starts the bundled local app automatically. Project data is stored outside the plugin cache by default.

Create a project

1. Turn the user's request into a complete shot list before calling the tool.
2. Call create_storyboard_project once with the project title, aspect ratio, all shots, and optional absolute designPath.
3. Do not create shots one at a time.
4. Return the created project ID and the project URL from the tool result. Tell the user to open that URL or refresh the storyboard if it is already open.
5. If any shot uses remotion or hyperframes, mention that generation requires the corresponding plugin or local toolchain before processing assets.

Each shot should include:

• rollType: A-ROLL for primary presentation or spoken footage; B-ROLL for supporting visuals.
• mediaType: image or video.
• duration: seconds.
• dialogue: spoken line for the shot.
• visualPrompt: concrete visual description used for asset generation.
• generator: manual, image-gen, hyperframes, or remotion.
• notes: editing, pacing, transition, or production notes.

Choose generator deliberately:

• manual: recorded presenter footage, screen recordings, or existing local material.
• image-gen: a static generated visual.
• hyperframes: designed motion graphics or interface animation.
• remotion: programmatic React-based video composition.

Find and inspect

• Use list_storyboard_projects first when the project ID is unknown. Pass query when the user gives a title.
• Use get_storyboard_project only when complete shot content is needed.
• Do not fetch every full project merely to find one title.

Update

Use one update_storyboard_project call:

• title or aspectRatio for project metadata.
• appendShots for new shots.
• shotUpdates for specific existing shots.
• deleteShotIds for removed shots.
• designPath to import or replace DESIGN.md.
• removeDesign: true to remove it.

Fetch the complete project first only when shot IDs or existing content are required.

Delete

Project deletion permanently removes the project and its local media. Ask for explicit confirmation immediately before calling delete_storyboard_project.

Token discipline

• Create the complete project with one MCP call.
• Prefer project summaries over full project reads.
• Return concise results instead of repeating the full script after it has been written.