Skillget

vibeframe

mcp
SUMMARY

AI-Native Video Editor — CLI-first, MCP-ready. Generate, edit, and ship videos from your terminal.

README.md

VibeFrame

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

License: MIT
Tests

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.

Reviews (0)

No results found