# ИИ-плагины

Плагин Elide подключает Claude Code или Codex к Elide, установленному на вашей машине. Агент находит проект, собирает
наименьшую нужную цель, читает сбои тестов с файлом и строкой, находит непротестированный код, читает Javadoc и
исходники ваших зависимостей и собирает трассы и журналы, пока выполняет команду. Он работает через структурированные
инструменты, а не разбирает вывод терминала.

- [Плагин Claude Code](/docs/ai-plugins-claude-code): инструменты проекта, навык `elide-dev` и результаты сборок, которые
  попадают прямо в вашу сессию.
- [Плагин Codex](/docs/ai-plugins-codex): инструменты проекта, навык `elide-dev` и контекст проекта при каждом запросе.

## Что входит в плагин

| Часть | Claude Code | Codex | Назначение |
| --- | --- | --- | --- |
| MCP-сервер проекта | Да | Да | Запускает `elide mcp`: [инструменты проекта](/docs/mcp#tools) для сборок, тестов, покрытия, документации зависимостей и телеметрии. |
| Навык `elide-dev` | Да | Да | Обучает агента порядку работы: сначала изучить проект, опрашивать сборки, читать отчёты как доказательства. |
| Канал результатов сборки | Да | Нет | Сообщает сессии, что сборка завершилась или у записи телеметрии есть результаты. |
| Хуки контекста | Нет | Да | Добавляют короткие подсказки по проекту при запуске сессии и при каждом запросе. |

Плагин использует установленный у вас `elide`. Он не устанавливает Elide, сам не запускает сборки и не меняет
разрешения вашего клиента: сборка, запуск кода и загрузка зависимостей по-прежнему требуют вашего подтверждения.

## Установка

Установите Elide и убедитесь, что оболочка вашего агента его находит:

```bash
elide --version
```

Скачайте `elide-agent-plugin.zip` из [последнего выпуска](https://github.com/elide-dev/elide/releases/latest) и
распакуйте его в каталог, который вы сохраните:

```bash
curl -fsSLO https://github.com/elide-dev/elide/releases/latest/download/elide-agent-plugin.zip
unzip -o elide-agent-plugin.zip -d ~/.local/share/elide-agent-plugin
```

В архиве лежат плагин и локальный маркетплейс для каждого клиента. Затем установите плагин в своём клиенте:

```bash
claude plugin marketplace add ~/.local/share/elide-agent-plugin
claude plugin install elide@elide-local
```

```bash
codex plugin marketplace add ~/.local/share/elide-agent-plugin
codex plugin add elide@elide-local
```

Запустите сессию в каталоге проекта и задайте вопрос о нём.

## Примеры

```text
elide test fails on main. Find out why and fix it.
```

Агент вызывает `project/context`, выбирает цель через `build/inspect`, запускает её через `build/run`, ждёт по
`build/status`, затем читает `build/diagnostics` и `tests/reports`, чтобы найти упавший тест, его файл и строку.

```text
Which files under src/ have the least test coverage? Add tests for the worst one.
```

```text
Show me the Javadoc for ImmutableList in the Guava version this project uses.
```

```text
Run the checkout tests and show me every span slower than 250 ms.
```

Последний запрос запускает запись телеметрии с фильтром вроде `signal == 'traces' && durationMs >= 250`, выполняет тесты
через неё и считывает подходящие спаны.

## Плагин или прямое подключение

Установите плагин или подключите `elide mcp` сами, как описано на странице
[MCP-сервера проекта](/docs/mcp#connect-your-agent), но не оба варианта сразу: каждый регистрирует сервер с именем `elide`,
и две копии дублируют все инструменты.

Плагин не включает [MCP-сервер документации](/docs/mcp-docs). Добавьте его, чтобы искать по этой документации и
[сообщать о проблемах](/docs/reporting-issues) из той же сессии:

```bash
claude mcp add --transport http elide-docs https://elide.help/mcp
codex mcp add elide-docs --url https://elide.help/mcp
```

## Обновление и удаление

Чтобы обновить плагин, распакуйте более новый `elide-agent-plugin.zip` поверх того же каталога и переустановите:

```bash
claude plugin marketplace update elide-local
claude plugin update elide@elide-local
```

```bash
codex plugin add elide@elide-local
```

Чтобы удалить, выполните `claude plugin uninstall elide@elide-local` или `codex plugin remove elide@elide-local`.

Версия плагина совпадает с версией Elide, с которой он поставляется. К архиву прилагаются контрольные суммы SHA-256 и
SHA-512.