Brief-to-MP4 workflow for coding agentsv0.106.0

Brief to MP4
with your coding agent.

The CLI is the agent workflow layer.

VibeFrame turns a written brief into STORYBOARD.md and DESIGN.md and then routes asset generation, scene composition, build reports, render inspection, and final MP4 export through commands any bash-capable coding agent can run.

agent loop
# Brief → project files → generated assets → MP4
# brief.md can be messy notes; media/ can hold your files
mkdir -p launch/media
vibe setup --scope project
vibe init launch --from brief.md --json
# Agent researches the topic, then edits STORYBOARD.md + DESIGN.md
vibe storyboard validate launch --json
vibe plan launch --json
vibe build launch --dry-run --max-cost 5 --json
vibe build launch --max-cost 5 --json
vibe status project launch --refresh --json
vibe inspect project launch --json
vibe render launch -o renders/final.mp4 --json
vibe inspect render launch --cheap --json
✓ review-report.json ready for the next agent pass
Intent
STORYBOARD.md
Design
DESIGN.md
Build
build-report.json
Review
review-report.json
$curl -fsSL https://vibeframe.ai/install.sh | bash
Process and result

The first-run agent loop, end to end.

brief.md can be rough notes, pasted research, links, or a one-line idea. Optional photos, logos, screenshots, clips, or voice files can live in media/. A coding agent then edits STORYBOARD.md and DESIGN.md, runs the build, reviews the reports, and renders the MP4.

Demo
Process highlight

Agent loop in under a minute

From rough brief and optional media inputs through setup, research, storyboard/design updates, image cues, build, render, and review.

Demo
Final result

The rendered MP4

The shareable MP4 from the storyboard-driven build path, without exposing the whole process.

BUILD

Primary path: rough brief, optional media, setup, init, storyboard/design, generated assets, composition, render.

GENERATE

Escape hatch: ask for one standalone image, video, narration, music, or motion asset.

EDIT / REMIX

Escape hatch: change existing media with captions, reframe, highlights, overlays, BGM, cleanup.

From install to MP4

Project files, reports, final render.

Use a rough brief and optional media/ inputs first. Lower-level media, scene, timeline, and YAML commands stay available when an agent needs to debug a specific stage.

1. Install · global
curl -fsSL https://vibeframe.ai/install.sh | bash

Adds the vibe CLI.

2. Configure · project keys
vibe setup --scope project

Writes ./.vibeframe/config.yaml for this workspace.

3. Draft · project files
vibe init launch --from brief.md --json

Reads rough brief.md. Optional source files live in launch/media/.

4. Plan · cost gate
vibe build launch --dry-run --max-cost 5 --json

Shows missing cues, provider needs, estimated cost, and planned assets.

5. Build · review · render
vibe build launch --json && vibe render launch --json && vibe inspect render launch --cheap --json

Writes reports agents can inspect, repair, and re-render.

Primary path: BUILD from storyboard via vibe build. Existing-media workflows still use vibe remix, edit, and audio.

CLI-First

The project loop is a command sequence

Agents can reason from structured files and JSON reports instead of guessing which UI state changed.

terminal
# Create a project from intent
vibe init my-video --from "45-second launch video" --json
✓ STORYBOARD.md + DESIGN.md created

# Validate, plan, and dry-run before spending
vibe storyboard validate my-video --json
vibe plan my-video --json
vibe build my-video --dry-run --max-cost 5 --json
✓ build-report.json includes cost and missing cues

# Build, review, repair, render
vibe build my-video --max-cost 5 --json
vibe status project my-video --refresh --json
vibe inspect project my-video --json
vibe scene repair my-video --json
vibe render my-video -o renders/final.mp4 --json
vibe inspect render my-video --cheap --json
✓ final.mp4 + review-report.json
Storyboard
list, get, set, move, validate, revise
Plan
costs, missing cues, provider needs
Build
assets, scene composition, timing sync
Review
inspect project, inspect render, reports
Repair
deterministic scene fixes after review
Primitives
generate, edit, remix, audio, YAML
Use with your AI agent

Natural language, report-driven commands

Describe the video. Your coding agent edits project files, callsvibewith JSON output, then uses reports for the next pass.

Build a 45-second launch video from brief.md and media/
vibe init launch --from brief.md --json && vibe build launch --dry-run --json
Revise the hook and keep the same visual system
vibe storyboard revise launch --from "stronger hook" --dry-run --json
Fix issues from the latest render review
vibe scene repair launch --json && vibe render launch --json && vibe inspect render launch --cheap --json

vibe doctor auto-detects six host families today and vibe init scaffolds the right project file for each.

Claude Code
CLAUDE.md + AGENTS.md
project guidance
OpenAI Codex
AGENTS.md
agents.md spec
Cursor
AGENTS.md + .cursor/rules
MCP-ready
Aider
AGENTS.md
binary-detected
Gemini CLI
AGENTS.md
universal fallback
OpenCode
AGENTS.md
MCP-ready

Anyone running another bash-capable agent gets the universalAGENTS.mdfallback.

Workflow guides

vibe context and guides

Agents can load the project rules, JSON envelope shape, public command surface, and step-by-step guides directly from the CLI.

vibe context

Load agent rules, JSON envelope conventions, project files, and report locations.

vibe guide scene

Scene authoring — STORYBOARD.md → composed video via vibe build and vibe render.

vibe schema --list --surface public

Expose the small first-run command set before an agent searches the full catalog.

List + load:
vibe guide # list available topicsvibe schema --list --surface public --json # compact command catalogvibe guide scene --json # structured workflow for an agent host

Guides are plain CLI commands, so they work the same from a terminal, Codex, Claude Code, Cursor, Aider, Gemini CLI, OpenCode, or any other host that can run shell commands.

MCP Ready

82 tools for Claude Desktop, Cursor, OpenCode, or Claude Code. MCP is optional; use it when your host prefers typed JSON-RPC tool calls over shell commands.

In Claude Desktop:

"Load the scene guide, build the storyboard project in demo-video, then render the final MP4"

initstoryboard_validateplanbuildinspect_projectscene_repair+76 more tools
Optional agent mode

Built-in AI agent, when you need one

Claude Code, Codex, Cursor, and other coding agents can drive vibe directly through shell commands and project guidance files. Run vibe agent only when you want a standalone natural-language session inside the CLI.

vibe
VibeFrame
v0.106.0 · openai · ~/demo-video
98 tools · cost gate (high/very-high)
Commands: exit · reset · tools · context

Natural Language

'Build this storyboard into a launch video' — when no host agent is available

6 LLM Providers

OpenAI, Claude, Gemini, xAI Grok, OpenRouter, Ollama — swap with -p flag

98 Tools

Project files, build reports, generation, media, export, filesystem

Fallback

Useful when no external coding agent or MCP host is available

Video as Code

Declarative YAML pipelines when you need them

The storyboard project loop is the default. Use YAML when you need a reproducible multi-step workflow with budget guards, checkpoints, and step references.

promo.yaml
name: asset-pipeline
steps:
  - id: backdrop
    action: generate-image
    prompt: "modern tech studio"
  - id: video
    action: generate-video
    image: $backdrop.output  # reference
  - id: narration
    action: generate-tts
    text: "Start with a storyboard."
    output: assets/narration.mp3
vibe run promo.yaml --dry-runvibe run promo.yaml --resume

Primary path and escape hatches

Start with the storyboard build. Drop into primitives only when an agent needs one asset, one edit, or one reproducible pipeline.

Storyboard Build

vibe build my-video --json

STORYBOARD.md + DESIGN.md to assets, scenes, reports

Video as Code

vibe run pipeline.yaml

Declarative YAML pipelines, --resume + budget guards

Auto Highlights

vibe remix highlights

Long video → AI analysis → best moments

Animated Captions

vibe remix animated-caption

Word-by-word TikTok/Reels-style captions

Auto Shorts

vibe remix auto-shorts

Long video → vertical shorts with captions

Auto Dub

vibe audio dub

Transcribe → translate → TTS in any language

Open source storyboard workflows for agents.

MIT licensed · v0.106.0 · project files, JSON reports, terminal commands, YAML, and MCP workflows.