Как поставить компонент VibeUI через ИИ-агента или shadcn CLI

VibeUI — shadcn-совместимый реестр. Проще всего нажать «Копировать для ИИ» на странице компонента и вставить текст в Cursor или Claude Code: агент сам выполнит npx shadcn add. Подписчики Pro могут один раз прописать namespace @vibeui в components.json и ставить компоненты по имени.

1. Copy for AI — для Cursor, Claude Code и других агентов

На странице компонента нажмите «Копировать для ИИ» и вставьте текст агенту. В инструкции — команда установки со ссылкой, которая действует 30 минут, зависимости, что сохранить (анимации, отступы, типографику, адаптив) и что можно менять (тексты, ссылки, цвет бренда). Агент ставит настоящий компонент, а не пишет похожий.

2. Команда npx shadcn add

Нужен проект с shadcn/ui (файл components.json). Войдите в аккаунт и откройте на странице компонента «Исходник компонента» — там команда с подписанной ссылкой на 30 минут. Голый адрес без подписи и без ключа вернёт 401: бесплатный лимит считается на человека.

npx shadcn@latest add "https://vibeui.ru/r/pro/hero-001.json?exp=…&sig=…"

3. Namespace @vibeui в components.json (Pro)

Создайте ключ в кабинете («Подключение к проекту»), положите его в .env.local как VIBEUI_TOKEN и добавьте реестр в components.json. Дальше компоненты ставятся по имени — так удобно и агенту, и CI.

{
  "registries": {
    "@vibeui": {
      "url": "https://vibeui.ru/r/pro/{name}.json",
      "headers": {
        "Authorization": "Bearer ${VIBEUI_TOKEN}"
      }
    }
  }
}

Установка по имени:

npx shadcn@latest add @vibeui/hero-001

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

Работает ли VibeUI в проекте, где уже есть shadcn/ui?

Да. Компоненты ставятся той же командой shadcn CLI и ложатся в папку components проекта; существующие компоненты shadcn/ui не трогаются.

Почему агент перерисовывает компонент вместо установки?

Если дать агенту только описание или скриншот, он пишет свою версию. Инструкция Copy for AI содержит точную команду установки и прямой запрет пересоздавать компонент — с ней агент ставит оригинал.

Нужен ли ключ для бесплатных компонентов?

Нет. Бесплатные компоненты ставятся по ссылке из Copy for AI или со страницы компонента после входа в аккаунт — 20 копирований в месяц. Ключ выдаётся с подпиской Pro.