# Plugins de IA

El plugin de Elide conecta Claude Code o Codex con el Elide instalado en su equipo. Su agente descubre el proyecto,
compila el destino más pequeño que importa, lee los fallos de las pruebas con archivo y línea, encuentra código sin
probar, lee el Javadoc y las fuentes de sus dependencias, y captura trazas y registros mientras ejecuta un comando.
Funciona mediante herramientas estructuradas en lugar de analizar la salida de la terminal.

- [Plugin de Claude Code](/docs/ai-plugins-claude-code): herramientas de proyecto, la skill `elide-dev` y los resultados de
  build enviados a su sesión.
- [Plugin de Codex](/docs/ai-plugins-codex): herramientas de proyecto, la skill `elide-dev` y el contexto del proyecto en
  cada prompt.

## Qué incluye el plugin

| Parte | Claude Code | Codex | Función |
| --- | --- | --- | --- |
| Servidor MCP del proyecto | Sí | Sí | Inicia `elide mcp`: [herramientas de proyecto](/docs/mcp#tools) para builds, pruebas, cobertura, documentación de dependencias y telemetría. |
| Skill `elide-dev` | Sí | Sí | Enseña al agente el flujo de trabajo: descubrir primero, consultar el estado de los builds, leer los informes como evidencia. |
| Canal de resultados de build | Sí | No | Avisa a la sesión cuando termina un build o una captura de telemetría tiene resultados. |
| Hooks de contexto | No | Sí | Añade una guía breve y adaptada al proyecto al iniciar una sesión y en cada prompt. |

El plugin usa su `elide` instalado. No instala Elide, no ejecuta builds por sí mismo ni cambia los permisos de su
cliente: compilar, ejecutar código y descargar dependencias siguen pidiendo su aprobación.

## Instalar

Instale Elide y compruebe que la shell de su agente lo encuentra:

```bash
elide --version
```

Descargue `elide-agent-plugin.zip` de la [última versión](https://github.com/elide-dev/elide/releases/latest) y
extráigalo en un directorio que conserve:

```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
```

El archivo contiene el plugin y un marketplace local para cada cliente. Luego instálelo en su cliente:

```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
```

Inicie una sesión en el directorio de su proyecto y haga una pregunta sobre él.

## Ejemplos

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

El agente llama a `project/context`, elige el destino con `build/inspect`, lo inicia con `build/run`, espera con
`build/status` y luego lee `build/diagnostics` y `tests/reports` para obtener la prueba que falla, su archivo y su
línea.

```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.
```

El último inicia una captura de telemetría con un filtro como `signal == 'traces' && durationMs >= 250`, ejecuta las
pruebas a través de ella y devuelve los spans que coinciden.

## Plugin o conexión directa

Instale el plugin, o conecte `elide mcp` usted mismo como indica la página del
[servidor MCP del proyecto](/docs/mcp#connect-your-agent), pero no ambos: cada uno registra un servidor llamado `elide` y
dos copias duplican todas las herramientas.

El plugin no incluye el [servidor MCP de documentación](/docs/mcp-docs). Añádalo para buscar en esta documentación y
[reportar problemas](/docs/reporting-issues) desde la misma sesión:

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

## Actualizar y eliminar

Para actualizar, extraiga un `elide-agent-plugin.zip` más reciente sobre el mismo directorio y reinstale:

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

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

Para eliminarlo, ejecute `claude plugin uninstall elide@elide-local` o `codex plugin remove elide@elide-local`.

La versión del plugin coincide con la versión de Elide con la que se distribuye. Junto al archivo se publican sumas de
verificación SHA-256 y SHA-512.