Skip to main content
Velt provides a layered AI toolchain that helps coding agents write correct Velt integration code on the first try. Think of it like a combo meal: each component plays a distinct role, and together they give your AI agent everything it needs.
ComponentRoleAnalogy
PluginCombo meal packaging: bundles skills, rules, an agent persona, and MCP servers into one installThe box
MCP InstallerWHAT to do, WHEN, in what ORDER: guided setup with codebase scanning and plan generationThe recipe card
SkillsHOW to implement Velt features and code: 140+ prioritized rules with correct/incorrect patternsThe cookbook
CLIQuick-start scaffolding (login, setup doc, user). Non-interactive, flag-driven setupThe pre-made base
Velt Docs MCPFALLBACK ONLY when skills don’t cover it. Search Velt docs directly from your editorEmergency hotline

​
How They Fit Together

Plugin (the box)
├── MCP Installer (the recipe card)   → plans and executes setup steps
├── Skills (the cookbook)              → teaches correct Velt patterns
├── CLI (the pre-made base)           → quick-start scaffolding
└── Velt Docs MCP (emergency hotline) → fallback docs search
The Plugin is the recommended starting point. It installs everything in one step. If you only need part of the stack, each component also works standalone.

​
Choose Your Path

AI Plugin (Recommended)

Full package for Cursor or Claude Code. Installs skills, rules, MCP servers, and the velt-expert agent persona.

MCP Installer

AI-guided setup with codebase scanning. Works with Claude Code, Cursor, Windsurf, and Claude Desktop.

Agent Skills

Install 140+ implementation rules for any AI agent. Works with Claude Code, Cursor, GitHub Copilot, and more.

CLI

Non-interactive, flag-driven scaffolding for Next.js. No AI agent required.

​
When to Use What

ScenarioUse
First time setting up Velt with an AI editorPlugin: gives your agent everything at once
Already have the plugin, adding a new featureYour agent uses Skills automatically when it detects a Velt task
Using an editor without plugin supportMCP Installer + Skills installed separately
Want terminal-only setup, no AI agentCLI with feature flags
Agent can’t find the answer in skillsVelt Docs MCP searches the full documentation

​
What Each Component Provides

​
Plugin

Bundles all components below into a single install for Cursor or Claude Code. Includes 8 slash-command skills, 7 bundled agent-skill packages (140+ rules), 6 embedded best-practice rules, 1 agent persona (velt-expert), and 2 MCP servers.

​
MCP Installer

An MCP server that your AI agent uses to run guided Velt setup. It scans your codebase, detects your auth system and document structure, generates an implementation plan, and executes the plan with your approval. Supports both guided mode and CLI-only mode.

​
Skills

Structured knowledge packages containing prioritized rules with correct and incorrect code patterns, verification checklists, and source pointers. Available for 8 Velt feature areas: Setup, Comments, CRDT, Notifications, Recorder, Single Editor Mode, Self-Hosting Data, and Activity Logs.

​
CLI

A terminal command (npx @velt-js/add-velt) that scaffolds Velt into a Next.js project. Installs dependencies, generates components, and wires VeltProvider into your app layout. Supports feature flags for comments, notifications, presence, cursors, and CRDT.

​
Velt Docs MCP

An MCP server that searches Velt’s documentation. Use it as a fallback when skills don’t cover your specific question. Available for Claude, Claude Code, Cursor, and VS Code.