Convex Agent Plugins
Официальный плагин Convex для Cursor и Claude Code: правила, команды, MCP-подключение и хуки для бэкенда на TypeScript.
- 117 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Ключ развертывания дает MCP-серверу доступ к данным и функциям рабочего развертывания Convex.
- Команда `/add` скачивает скрипты и запускает их на вашей машине.
Установка
- Работает в
Ручная установка
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 для агентов: запуск проекта, аутентификация, компоненты, миграции и разбор проблем с производительностью
builder-skills — скиллы для приложений на Convex
builder-skills
17 скиллов учат агента писать приложения на Convex по документации и вести проект через PRD, task.md и журнал изменений
Официальный набор Tencent CloudBase для кодинг-агентов: плагин ставит стек, скиллы задают правила, MCP работает с бэкендом
MCP-сервер и плагин для агентов генерируют веб-API из спецификаций OpenAPI, AsyncAPI, GraphQL, gRPC и SQL на ядре Rust.
Бэкенд на PostgreSQL, который агент строит через MCP, а платформа проверяет каждое изменение и умеет откатить.
Plinth
plinth
Набор скиллов и агентов для разработки на Java: сборка, тесты, профилирование и архитектура. Установка одной командой для Claude Code, Cursor
Коротко о README
README делит плагин на правила, навыки, агентов, MCP и хуки. Отдельный раздел объясняет, чем хук Cursor отличается от блокирующего хука Claude Code.