# ШІ-плагіни

Плагін 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.