Overview

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.

Component	Role	Analogy
Plugin	Combo meal packaging: bundles skills, rules, an agent persona, and MCP servers into one install	The box
MCP Installer	WHAT to do, WHEN, in what ORDER: guided setup with codebase scanning and plan generation	The recipe card
Skills	HOW to implement Velt features and code: 277 prioritized rules with correct/incorrect patterns	The cookbook
CLI	Quick-start scaffolding (login, setup doc, user). Non-interactive, flag-driven setup	The pre-made base
Velt Docs MCP	FALLBACK ONLY when skills don’t cover it. Search Velt docs directly from your editor	Emergency 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 267 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

Scenario	Use
First time setting up Velt with an AI editor	Plugin: gives your agent everything at once
Already have the plugin, adding a new feature	Your agent uses Skills automatically when it detects a Velt task
Using an editor without plugin support	MCP Installer + Skills installed separately
Want terminal-only setup, no AI agent	CLI with feature flags
Agent can’t find the answer in skills	Velt 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 2 slash-command skills (/install-velt, /velt-help), 13 bundled agent-skill packages (277 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 13 Velt feature areas: Setup, Comments, CRDT, Notifications, Recorder, Single Editor Mode, Self-Hosting Data, Activity Logs, Presence, Cursors, Huddle, REST APIs, and Proxy Server.

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.

Get Started

Agentic Setup

Key Concepts

Async Collaboration

Realtime Collaboration

AI

Self-Host Data

Backend SDKs

Model Context Protocol

Webhooks

Security

Miscellaneous

How They Fit Together

Choose Your Path

AI Plugin (Recommended)

MCP Installer

Agent Skills

CLI

When to Use What

What Each Component Provides

Plugin

MCP Installer

Skills

CLI

Velt Docs MCP

​How They Fit Together

​Choose Your Path

AI Plugin (Recommended)

MCP Installer

Agent Skills

CLI

​When to Use What

​What Each Component Provides

​Plugin

​MCP Installer

​Skills

​CLI

​Velt Docs MCP

How They Fit Together

Choose Your Path

When to Use What

What Each Component Provides

Plugin

MCP Installer

Skills

CLI

Velt Docs MCP