Ваш агент работает лучше, когда знает, что такое vibe и как его вызывать. Эта страница кладёт короткий файл с инструкцией туда, где агент его читает, а для агентов, которые это поддерживают, запускает сервер, к которому агент обращается напрямую.
Агент выполняет `vibe mcp install --auto --yes`. vibe обнаруживает агентов на машине и записывает для каждого две вещи. Первая — запись в конфигурации агента, которая запускает `vibe mcp serve` как сервер, к которому агент может обращаться. Вторая — файл [навыка](../glossary/index.xml#skill), `SKILL.md`, который учит агента командам vibe и тому, когда ими пользоваться. Обе записи трогают только запись vibevm в каждой конфигурации; всё остальное в этих файлах остаётся как было. Команда идемпотентна: второй запуск сообщает о каждой неизменившейся записи как о неизменившейся.
Это работает благодаря двум поверхностям. `vibe mcp serve` — сервер Model Context Protocol, который отдаёт любому агенту состояние проекта, выведенное из лока, в виде инструментов, а команды `vibe mcp` подключают его к собственной конфигурации каждого агента и пишут его `SKILL.md`. Набор агентов фиксирован: Claude Code, Claude Code Desktop, Cursor, OpenCode и Codex. Каждый глагол идемпотентен на матрице «агент и область», предлагает `--dry-run` и спрашивает перед записью.
vibe пишет в тот файл, который каждый агент действительно читает при обнаружении: для Claude Code это `.mcp.json` в проекте или таблица серверов верхнего уровня в `~/.claude.json`, и никогда файл настроек, который их только ограничивает. Он вставляет или обновляет свою единственную запись и сохраняет каждый чужой ключ в его порядке, так что большая конфигурация дополняется, а не переписывается; удаление вычищает только запись vibe. Для агентов с папкой навыков, Claude Code, OpenCode и Codex, он также пишет `SKILL.md` о том, как пользоваться vibe через инструменты.
1. Сначала посмотрите план; ничего не записывается:
2. Установите для всех обнаруженных агентов или для одного: `--agent claude`, `--agent codex`, `--agent opencode`, `--agent cursor`, `--agent claude-desktop`:
3. Выберите область: `--scope project` пишет в папки агентов внутри проекта, `--scope user` — в вашу домашнюю конфигурацию, `--scope both` — в обе. Без проекта в текущей папке пользовательская область выбирается за вас.
Пакеты могут объявлять собственные навыки, и пакет может быть любого вида: flow приносит навык-чеклист, языковое руководство — навык обхода, руководство — навык чтения. `vibe skill list` показывает, что объявляют установленные пакеты, а `vibe skill install` проецирует их в папки навыков агентов. Установка навыка — это проекция файла, который пакет уже несёт, а не второй механизм доставки.
Навык этого руководства, `vibevm-docs`, приходит тем же путём, как только руководство оказывается в машинном [хранилище](../glossary/index.xml#store).
Пакет вида `mcp` доставляет сервер, собранный из его собственного кода, например инструменты дисциплины языкового [семейства](../glossary/index.xml#family). `vibe mcp install` регистрирует такие серверы в конфигурациях агентов рядом с сервером самого vibe, с путём к собранному бинарнику; `vibe mcp status` сообщает, собран ли каждый и актуален ли он. Зарегистрировать сервер — значит, что агент будет запускать код этого пакета в начале сессии, поэтому регистрация спрашивает согласия, как установка.
Каждый установленный пакет вида `mcp` вносит свои серверы в одну и ту же регистрацию, и она относится к проекту, потому что серверы проекта принадлежат его закоммиченной конфигурации. В JSON-файле vibe держит маленький список `vibevm.managed` с именами записей, которыми владеет, так что переустановка переписывает только их и никогда не трогает сервер, который вы добавили сами. Ворота согласия те же, что у бинарников: пакеты группы `org.vibevm` в белом списке, любому другому происхождению нужен `--assume-yes`. `vibe mcp status` говорит, собран ли бинарник каждого сервера.
`vibe mcp upgrade` после обновления vibe приводит существующие интеграции к форме, которую несёт текущий бинарник; ничего нового он не создаёт.
`vibe mcp uninstall` удаляет запись и навык vibe и оставляет каждую чужую запись на месте; `vibe skill uninstall` вычищает только навыки, которые спроецировал vibe.
Cursor и Claude Desktop принимают запись сервера, но папок навыков у них нет; vibe сообщает, что навык для них пропущен, а не выдумывает место.