The Liveblocks plugin helps AI coding assistants write Liveblocks and Yjs code. It bundles agent skills, MCP server configuration, and instruction files for AI coding tools.
Install the Liveblocks plugin:
npx plugins add liveblocks/liveblocks-pluginAfter installation, start a new thread in your AI coding tool so the Liveblocks skills and MCP server are available.
| Tool | Status |
|---|---|
| Claude Code | Supported |
| OpenAI Codex | Supported |
| Cursor | Supported |
| Grok Build | Supported |
| GitHub Copilot | Supported |
The plugins CLI currently installs the plugin automatically for Claude Code,
Cursor, and OpenAI Codex. Grok Build and GitHub Copilot can use the repository's
plugin manifest, skills, MCP configuration, and instruction files directly.
| Skill | Description | Source |
|---|---|---|
liveblocks-best-practices |
Best practices for Liveblocks rooms, auth, presence, Storage, comments, notifications, text editors, React patterns, and more. | Authored here |
yjs-best-practices |
Guidance for Yjs data modeling, updates, performance, subdocuments, providers, and common debugging issues. | Authored here |
The plugin includes the Liveblocks MCP server, giving agents tool access to create, modify, and delete different aspects of Liveblocks such as rooms, threads, comments, notifications, and more. It also has read access to Storage and Yjs.
Set a development project secret key before starting your coding agent:
export LIVEBLOCKS_SECRET_KEY="sk_..."Do not use a production secret key. The MCP server gives your agent direct access to inspect and modify data in that Liveblocks project.
After installation, skills are automatically available in your AI tool. Your agent will use them when it judges they are relevant.
How do I handle unstable Wi-Fi connections with Liveblocks?
How do I pass custom headers to my auth endpoint?
Why is my Y.Map growing so large?
The plugin package is available in
liveblocks/liveblocks-plugin.
Standalone skills are available in
liveblocks/skills.