Convex Agent Plugins

Официальный плагин Convex для Cursor и Claude Code: правила, команды, MCP-подключение и хуки для бэкенда на TypeScript.

  • 117 ★ репозитория
  • Последний коммит
  • MIT
Плагин

Широкий доступ

Почему такой уровень

  • Ключ развертывания дает MCP-серверу доступ к данным и функциям рабочего развертывания Convex.
  • Команда `/add` скачивает скрипты и запускает их на вашей машине.
Все причины и проверки

convex/convex-agent-plugins

Установка

Работает в

Ручная установка

cd ~/.cursor/plugins && git clone https://github.com/convex/convex-agent-plugins convex

Ручная установка из README, адрес репозитория подставлен вместо заглушки. После клонирования перезапустите Cursor, либо поставьте плагин через Cursor Marketplace.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Ключ развертывания дает MCP-серверу доступ к данным и функциям рабочего развертывания Convex.
  • Команда `/add` скачивает скрипты и запускает их на вашей машине.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Плагин Convex учит агента писать бэкенд на Convex, реактивной платформе с базой и серверными функциями на TypeScript. Правила применяются сами, пока агент работает в каталоге `convex/`: индексы вместо `.filter()`, проверка аргументов и прав, плоские схемы. Отдельные команды запускают типовые задачи: `/add`, `/migrate`, `/seed`, `/test`, `/deploy-guard`, `/ship`, `/optimize` и другие. Два агента, `convex-advisor` и `convex-reviewer`, советуют по архитектуре и проверяют код. Манифест подключает MCP-сервер `npx -y convex@latest mcp start`: он дает доступ к схеме, конфигурации и функциям развертывания. Хуки Cursor блокируют `git commit` с запросами на `Date.now()` и `.filter()` и после хода агента гоняют `npx tsc --noEmit`, при ошибках возвращая их агенту.

Для кого. Разработчикам на Convex, которые пишут бэкенд с Cursor или Claude Code и хотят следовать рекомендованным приемам платформы.

Подходит, если

  • Проект на Convex стартует с нуля, и агенту надо подготовить схему, права и первые функции.
  • Схему меняют на живых данных, и миграция должна пройти без простоя.
  • Перед коммитом хочется автоматически ловить запросы, которые ломают реактивность.
  • Код бэкенда проверяет рецензент, знающий типичные ошибки Convex.

Не подходит, если

  • Бэкенд написан не на Convex.
  • Ключ развертывания нельзя отдавать агенту.
  • Нужна жесткая блокировка конца хода при падении сборки: в Cursor хук `stop` только возвращает ошибки агенту.

Пример запроса к агенту

Подготовь схему Convex для таск-менеджера с пользователями, командами и задачами и добавь мутацию обновления задачи с проверкой владельца.

Ограничения

Плагин рассчитан на Cursor: хуки описаны по формату Cursor, а README называет Claude Code вторым поддерживаемым агентом, но отдельной инструкции по нему не дает. Для MCP задают `CONVEX_DEPLOYMENT` и `CONVEX_DEPLOY_KEY`. Хук `stop` повторяет ход не более двух раз и не может запретить завершение. Команда `/add` скачивает каталог возможностей и скрипты установки у сервиса Convex и запускает их, каждое скачивание записывается как анонимное событие. Без `/add` плагин ничего не отправляет.

Как отключить. Удалите каталог плагина из `~/.cursor/plugins` и перезапустите Cursor. Ключ `CONVEX_DEPLOY_KEY` уберите из окружения.

Частые вопросы

Как установить плагин Convex в Cursor?

Через Cursor Marketplace либо вручную: склонируйте репозиторий в `~/.cursor/plugins/convex` и перезапустите Cursor.

Какие переменные нужны для MCP?

`CONVEX_DEPLOYMENT` с именем развертывания и `CONVEX_DEPLOY_KEY`. Ключ берут в панели Convex Dashboard.

Что делают хуки плагина?

Перед `git commit` скрипт ищет `Date.now()` в запросах и `.filter()` после `db.query(...)` и может отклонить коммит. После хода агента, если есть каталог `convex/`, запускается `npx tsc --noEmit` и ошибки уходят агенту следующим сообщением.

Какие команды есть у плагина?

Среди них `/add`, `/migrate`, `/seed`, `/test`, `/deploy-guard`, `/ship`, `/optimize`, `/monitor`, `/crons` и `/env`.

Что делает команда `/add`?

Скачивает у сервиса Convex каталог возможностей и скрипты установки и запускает их. Каждое скачивание фиксируется как анонимное событие, без `/add` плагин ничего не отправляет.

Обсуждение

Вопросов и отзывов пока нет.

Плагины
Официальный

Скиллы Convex для агентов: запуск проекта, аутентификация, компоненты, миграции и разбор проблем с производительностью

СкиллМинимальный доступ69Звезды репозитория

17 скиллов учат агента писать приложения на Convex по документации и вести проект через PRD, task.md и журнал изменений

СкиллРасширенный доступ404Звезды репозитория
Официальный

Официальный набор Tencent CloudBase для кодинг-агентов: плагин ставит стек, скиллы задают правила, MCP работает с бэкендом

ПлагинШирокий доступ1,2 тыс.Звезды репозитория

MCP-сервер и плагин для агентов генерируют веб-API из спецификаций OpenAPI, AsyncAPI, GraphQL, gRPC и SQL на ядре Rust.

MCP-серверРасширенный доступ123Звезды репозитория
Официальный

Бэкенд на PostgreSQL, который агент строит через MCP, а платформа проверяет каждое изменение и умеет откатить.

MCP-серверРасширенный доступ83Звезды репозитория

Plinth

plinth

Набор скиллов и агентов для разработки на Java: сборка, тесты, профилирование и архитектура. Установка одной командой для Claude Code, Cursor

СкиллМинимальный доступ462Звезды репозитория

Коротко о README

README делит плагин на правила, навыки, агентов, MCP и хуки. Отдельный раздел объясняет, чем хук Cursor отличается от блокирующего хука Claude Code.

Бейдж для README

Сообщить о проблеме