> ## Documentation Index
> Fetch the complete documentation index at: https://velt.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Use AI coding agents to build with Velt. Understand how plugins, the MCP installer, skills, the CLI, and the Velt Docs MCP work together.

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](/get-started/plugins)**              | Combo meal packaging: bundles skills, rules, an agent persona, and MCP servers into one install | The box           |
| **[MCP Installer](/get-started/mcp-installer)** | WHAT to do, WHEN, in what ORDER: guided setup with codebase scanning and plan generation        | The recipe card   |
| **[Skills](/get-started/skills)**               | HOW to implement Velt features and code: 277 prioritized rules with correct/incorrect patterns  | The cookbook      |
| **[CLI](/get-started/cli)**                     | Quick-start scaffolding (login, setup doc, user). Non-interactive, flag-driven setup            | The pre-made base |
| **[Velt Docs MCP](/mcp/mcp#docs-mcp-server)**   | 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

<CardGroup cols={2}>
  <Card title="AI Plugin (Recommended)" icon="box" href="/get-started/plugins" color="#7CE38B" iconType="light">
    Full package for Cursor or Claude Code. Installs skills, rules, MCP servers, and the velt-expert agent persona.
  </Card>

  <Card title="MCP Installer" icon="wand-magic-sparkles" href="/get-started/mcp-installer" color="#77BDFB" iconType="light">
    AI-guided setup with codebase scanning. Works with Claude Code, Cursor, Windsurf, and Claude Desktop.
  </Card>

  <Card title="Agent Skills" icon="book" href="/get-started/skills" color="#FAA356" iconType="light">
    Install 267 implementation rules for any AI agent. Works with Claude Code, Cursor, GitHub Copilot, and more.
  </Card>

  <Card title="CLI" icon="terminal" href="/get-started/cli" color="#D5D5D5" iconType="light">
    Non-interactive, flag-driven scaffolding for Next.js. No AI agent required.
  </Card>
</CardGroup>

## 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.