# Reportar problemas

¿Algo falló, fue más lento de lo debido, le sorprendió o falta? Los errores y las solicitudes se siguen en público en
[elide-dev/elide](https://github.com/elide-dev/elide/issues). Elija el camino que más le convenga.

| Camino | Úselo cuando | Inicio |
| --- | --- | --- |
| Su agente de programación | Trabaja en Claude Code, Codex, Cursor u otro cliente MCP. | [Reportar desde su agente](#report-from-your-agent) |
| Issue de GitHub | Quiere crear y seguir el issue usted mismo. | [Crear un issue de GitHub](#file-a-github-issue) |
| Discord | Quiere ayuda ahora o no está seguro de que sea un error. | [elide.dev/discord](https://elide.dev/discord) |
| Aviso de seguridad | El problema es una vulnerabilidad. | [Repórtelo en privado](#security-vulnerabilities) |

## Reportar desde su agente

Conecte una vez el [servidor MCP de documentación](/docs/mcp-docs) público:

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

Luego cuente a su agente qué salió mal:

```text
elide test hangs after the last test passes. Report it to Elide.
```

El agente busca un issue existente, reúne evidencia con `elide agent` y le muestra una vista previa con los secretos,
las rutas del directorio personal y las direcciones de correo eliminados. No se envía nada hasta que usted confirma.
Los reportes aceptados se convierten en issues públicos, normalmente en menos de una hora.

Mientras trabaja, el servidor también pide a su agente que detecte fallos, ejecuciones lentas y sorpresas, y que le
ofrezca un reporte.

- [Reportar desde su agente](/docs/agentic-reporting): tipos de reporte, el paso de confirmación, la evidencia y qué se
  almacena.
- [Del reporte a la corrección](/docs/agentic-triage): qué ocurre después y cómo seguir un reporte.

## Crear un issue de GitHub

`elide agent bug` imprime el cuerpo de un issue con su versión de Elide y su plataforma ya rellenadas. No envía nada.

```bash
elide agent bug
```

```text
File this report at https://github.com/elide-dev/elide/issues
Or send it through the docs MCP server at https://elide.help/mcp

---

### What happened

<!-- the command you ran, what you expected, what occurred -->

### Environment

| key | value |
| --- | --- |
| version | 1.6.3 |
| platform | linux-amd64 |
…
```

Abra un [issue nuevo](https://github.com/elide-dev/elide/issues/new), pegue el cuerpo y rellene qué ocurrió.

Incluya lo que corresponda al problema:

| Problema | Incluya |
| --- | --- |
| Error o fallo | El comando, su salida completa y el archivo más reciente de `crash_root`, si se escribió alguno. |
| Resultado incorrecto | Lo que esperaba, lo que obtuvo y por qué: una página de la documentación o la salida de otro entorno de ejecución. |
| Ejecución lenta | Los tiempos de `elide agent perf` frente al entorno de ejecución o la versión de Elide con que comparó. |
| Función que falta | Qué construiría con ella. |

`elide agent diagnostics` imprime su versión, su plataforma y el directorio de informes de fallos (`crash_root`). El
proyecto o archivo más pequeño que reproduzca el problema es el que se corrige más rápido.

```bash
elide agent diagnostics
elide agent perf --baseline "node app.ts" -- elide run app.ts
elide agent perf --against 1.6.2 -- elide run app.ts
```

`--against` ejecuta una versión de Elide que ya tiene instalada; nunca descarga ninguna.

## Vulnerabilidades de seguridad

Reporte una vulnerabilidad en privado mediante los
[avisos de seguridad de GitHub](https://github.com/elide-dev/elide/security/advisories/new). No abra un issue público,
no publique en Discord ni la envíe por el servidor MCP de documentación, que crea issues públicos.

## Antes de reportar

- [Solución de problemas](/docs/troubleshooting) cubre los errores habituales con sus soluciones.
- [Compatibilidad](/docs/compatibility) y el [resumen de la API](/docs/api-overview) listan lo que Elide aún no admite.
- `elide --version` debería coincidir con la última versión; consulte [Actualización](/docs/upgrading).
- Una página de la documentación incorrecta o ausente también merece un reporte: use **¿Le resultó útil esta
  página?** al final de la página, o reporte una `expectation` con la página como base.
