{"id":51040251,"url":"https://github.com/liveblocks/liveblocks-plugin","last_synced_at":"2026-06-22T10:02:25.707Z","repository":{"id":365677865,"uuid":"1273142350","full_name":"liveblocks/liveblocks-plugin","owner":"liveblocks","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-18T10:29:23.000Z","size":136,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-18T12:23:36.778Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/liveblocks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-18T08:45:13.000Z","updated_at":"2026-06-18T10:29:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/liveblocks/liveblocks-plugin","commit_stats":null,"previous_names":["liveblocks/liveblocks-plugin"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/liveblocks/liveblocks-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liveblocks%2Fliveblocks-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liveblocks%2Fliveblocks-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liveblocks%2Fliveblocks-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liveblocks%2Fliveblocks-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liveblocks","download_url":"https://codeload.github.com/liveblocks/liveblocks-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liveblocks%2Fliveblocks-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34643624,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-22T02:00:06.391Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-22T10:02:25.141Z","updated_at":"2026-06-22T10:02:25.701Z","avatar_url":"https://github.com/liveblocks.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://liveblocks.io#gh-light-mode-only\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/liveblocks/liveblocks/main/.github/assets/header-light.svg\" alt=\"Liveblocks\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://liveblocks.io#gh-dark-mode-only\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/liveblocks/liveblocks/main/.github/assets/header-dark.svg\" alt=\"Liveblocks\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# Liveblocks plugin\n\nThe Liveblocks plugin helps AI coding assistants write Liveblocks and Yjs code.\nIt bundles agent skills, MCP server configuration, and instruction files for\nAI coding tools.\n\n## Install\n\nInstall the Liveblocks plugin:\n\n```bash\nnpx plugins add liveblocks/liveblocks-plugin\n```\n\nAfter installation, start a new thread in your AI coding tool so the Liveblocks\nskills and MCP server are available.\n\n## Supported tools\n\n| Tool                                                          | Status    |\n| ------------------------------------------------------------- | --------- |\n| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | Supported |\n| [OpenAI Codex](https://openai.com/codex)                      | Supported |\n| [Cursor](https://www.cursor.com/)                             | Supported |\n| [Grok Build](https://x.ai/news/grok-build-cli)                | Supported |\n| [GitHub Copilot](https://github.com/features/copilot)         | Supported |\n\nThe `plugins` CLI currently installs the plugin automatically for Claude Code,\nCursor, and OpenAI Codex. Grok Build and GitHub Copilot can use the repository's\nplugin manifest, skills, MCP configuration, and instruction files directly.\n\n## Available skills\n\n| Skill                                                             | Description                                                                                                                    | Source        |\n| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------- |\n| [`liveblocks-best-practices`](./skills/liveblocks-best-practices) | Best practices for Liveblocks rooms, auth, presence, Storage, comments, notifications, text editors, React patterns, and more. | Authored here |\n| [`yjs-best-practices`](./skills/yjs-best-practices)               | Guidance for Yjs data modeling, updates, performance, subdocuments, providers, and common debugging issues.                    | Authored here |\n\n## MCP server\n\nThe plugin includes the\n[Liveblocks MCP server](https://github.com/liveblocks/liveblocks-mcp-server),\ngiving agents tool access to create, modify, and delete different aspects of\nLiveblocks such as rooms, threads, comments, notifications, and more. It also\nhas read access to Storage and Yjs.\n\nSet a development project secret key before starting your coding agent:\n\n```bash\nexport LIVEBLOCKS_SECRET_KEY=\"sk_...\"\n```\n\nDo not use a production secret key. The MCP server gives your agent direct\naccess to inspect and modify data in that Liveblocks project.\n\n## When to use\n\nAfter installation, skills are automatically available in your AI tool. Your\nagent will use them when it judges they are relevant.\n\n### Examples\n\n```\nHow do I handle unstable Wi-Fi connections with Liveblocks?\n```\n\n```\nHow do I pass custom headers to my auth endpoint?\n```\n\n```\nWhy is my Y.Map growing so large?\n```\n\n## Source code\n\nThe plugin package is available in\n[`liveblocks/liveblocks-plugin`](https://github.com/liveblocks/liveblocks-plugin).\n\nStandalone skills are available in\n[`liveblocks/skills`](https://github.com/liveblocks/skills).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliveblocks%2Fliveblocks-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliveblocks%2Fliveblocks-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliveblocks%2Fliveblocks-plugin/lists"}