VibeFrame

AI-native video editing. CLI-first. MCP-ready.

Edit videos with natural language. Every edit is a command. Every workflow is scriptable.

---

Demo

CLI walkthrough → https://youtu.be/EJUUpPp2d_8

Claude Code integration → https://youtu.be/sdf930sZ7co

---

Why VibeFrame?

Traditional video editors are built for clicking buttons. VibeFrame is built for AI-powered workflows.

Traditional Editor	VibeFrame
Import → Drag → Trim → Export	vibe edit silence-cut interview.mp4 -o clean.mp4
Manual scene detection	vibe detect scenes video.mp4
Export for each platform	vibe pipeline viral project.vibe.json
Click through menus	Natural language → CLI → done

Design Principles: Headless First — AI-Native — MCP Compatible — Provider Agnostic

---

Quick Start (CLI)

Prerequisites: Node.js 20+, FFmpeg

CLI-first. Every video edit is a command.

# Install
curl -fsSL https://vibeframe.ai/install.sh | bash

# Remove silence from an interview
vibe edit silence-cut interview.mp4 -o clean.mp4

# Add captions with auto-transcription
vibe edit caption video.mp4 -o captioned.mp4

# Create a TikTok from a script
vibe pipeline script-to-video "A day in the life of a developer..." -a 9:16 -o ./tiktok/

# Export to MP4
vibe export project.vibe.json -o output.mp4

For development:

git clone https://github.com/vericontext/vibeframe.git
cd vibeframe
pnpm install && pnpm build

---

Use with Claude Code

Already have the CLI installed? Claude Code runs vibe commands for you — just describe what you want in natural language.

You say	Claude Code runs
"Remove silence from interview.mp4"	vibe edit silence-cut interview.mp4 -o clean.mp4
"Extract 3 best moments from podcast.mp4"	vibe pipeline highlights podcast.mp4 -c 3
"Add Korean subtitles to video.mp4"	vibe edit caption video.mp4 -o captioned.mp4
"Create a TikTok from this script"	vibe pipeline script-to-video "..." -a 9:16
"Remove background noise"	vibe edit noise-reduce noisy.mp4 -o clean.mp4
"Make a 60-second highlight reel"	vibe pipeline highlights long-video.mp4 -d 60

No setup needed beyond installing the CLI. Claude Code discovers and runs vibe commands directly.

---

MCP Integration

Works with Claude Desktop and Cursor via MCP. No clone needed — just add to your config and restart:

{
  "mcpServers": {
    "vibeframe": {
      "command": "npx",
      "args": ["-y", "@vibeframe/mcp-server"]
    }
  }
}

Config file locations:

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
• Cursor: .cursor/mcp.json in your workspace

28 Tools | 5 Resources | 7 Prompts — see packages/mcp-server/README.md for details.

---

AI Pipelines

End-to-end workflows powered by multiple AI providers (Claude + ElevenLabs + Gemini + Kling/Runway):

vibe pipeline script-to-video "A morning routine of a startup founder..." \
  -d 60 -a 9:16 -g kling -o startup.vibe.json

vibe pipeline highlights interview.mp4 -d 90 --criteria emotional
vibe pipeline auto-shorts podcast.mp4
vibe pipeline b-roll podcast.mp3 --broll-dir ./footage
vibe pipeline viral project.vibe.json --platforms tiktok,youtube-shorts,instagram-reels

---

CLI Reference

Every command supports --help. Run vibe --help for a full list.

Group	Commands	Example
vibe generate	image, video, speech, sound-effect, music, motion, storyboard, thumbnail, background	vibe generate image "prompt" -o img.png
vibe edit	silence-cut, jump-cut, caption, grade, reframe, speed-ramp, text-overlay, fade, noise-reduce, image, fill-gaps	vibe edit caption video.mp4 -o out.mp4
vibe analyze	media, video, review, suggest	vibe analyze media video.mp4 "summarize"
vibe audio	transcribe, voices, isolate, voice-clone, dub, duck	vibe audio transcribe audio.mp3
vibe pipeline	script-to-video, highlights, auto-shorts, viral, b-roll, narrate, regenerate-scene	vibe pipeline script-to-video "..." -a 9:16
vibe project	create, info, set	vibe project create "name"
vibe timeline	add-source, add-clip, split, trim, move, delete, list	vibe timeline add-source project file
vibe batch	import, concat, apply-effect	vibe batch import project dir/
vibe detect	scenes, silence, beats	vibe detect scenes video.mp4
vibe export	-	vibe export project.vibe.json -o out.mp4

43 AI commands across 5 groups and 11 providers. Every command supports --help, --json, and --dry-run.

---

Agent Mode

For environments without Claude Code or MCP, run vibe for an interactive natural language session:

vibe                           # Start Agent mode (default: OpenAI)
vibe agent -p claude           # Use Claude
vibe agent -p gemini           # Use Gemini
vibe agent -p xai              # Use xAI Grok
vibe agent -p ollama           # Use local Ollama

57 tools across project, timeline, AI generation, media, export, batch, and filesystem. The LLM reasons, calls tools, and executes autonomously.

---

AI Providers

See MODELS.md for detailed model information (SSOT).

Category	Providers	Default
Agent LLM	OpenAI, Claude, Gemini, xAI, Ollama	GPT-5-mini
Image	Gemini, OpenAI, xAI Grok	Gemini Nano Banana
Video	xAI Grok, Kling, Runway, Veo	Grok Imagine
Audio	ElevenLabs, Whisper	-

Required API Keys: OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, ELEVENLABS_API_KEY, RUNWAY_API_SECRET, KLING_API_KEY, XAI_API_KEY

---

Project Structure

vibeframe/
├── packages/
│   ├── cli/               # CLI + Agent (57 tools, 248+ tests)
│   ├── core/              # Timeline engine (Zustand + Immer + FFmpeg)
│   ├── ai-providers/      # Pluggable AI providers
│   ├── mcp-server/        # MCP server (npm: @vibeframe/mcp-server)
│   └── ui/                # Shared React components
├── apps/web/              # Next.js landing & preview UI
├── MODELS.md              # AI models reference (SSOT)
└── ROADMAP.md             # Development roadmap

---

Roadmap

Phase	Status	Description
1. Foundation	Done	Core CLI, FFmpeg.wasm export
2. AI Providers	Done	11 providers integrated
3. MCP Integration	Done	Claude Desktop & Cursor support
4. AI Pipelines	Done	Script-to-Video, Highlights, B-Roll, Viral
5. Server Infrastructure	Planned	Hybrid rendering, chunked uploads
6. Collaboration	Planned	CRDT-based local-first sync

See ROADMAP.md for details.

---

Open Core Model

VibeFrame Core is 100% open source (MIT License). Core features will always remain free and open source.

---

Contributing

pnpm build     # Build all packages
pnpm test      # Run tests (248+ passing)
pnpm lint      # Lint code

Contributions welcome — AI provider integrations, CLI improvements, docs, bug fixes & tests. See CONTRIBUTING.md.

---

License

MIT - see LICENSE

---

Built for the AI age. Ship videos, not clicks.