# ACP — conecta tu editor

> Conecta Zed, VS Code, JetBrains o neovim a un agente de Ghosty Studio por el Agent Client Protocol.

URL: https://www.ghosty.studio/docs/protocolos/acp

Tu agente corre en su propia máquina, con su disco y su terminal. Desde tu editor le hablas por **ACP** (Agent Client Protocol), el protocolo abierto que usan Zed, JetBrains y las extensiones de VS Code y neovim.

## Por qué hace falta un puente

Los editores no se conectan a una dirección web: lanzan un **comando** y le hablan por entrada y salida estándar. Tu agente vive detrás de un WebSocket. El puente hace ese cambio de cable y nada más: no lleva ningún secreto y puedes leerlo entero, son sesenta líneas.

## 1. Nada que instalar

El puente se llama `ghosty-acp` y lo descarga `npx` solo, igual que hacen Claude Code, Gemini CLI o Copilot en cualquier editor. Sólo necesitas Node 22 o superior.

```bash
npx -y ghosty-acp wss://tu-agente/acp
```

No tiene dependencias ni scripts de instalación. Está publicado en npm bajo licencia MIT.

## 2. Copia tu configuración

En Studio, entra a tu agente y abre **Conexión ACP**. Ahí generas el token y te damos el bloque listo para pegar, con tu dirección y tu token ya dentro.

**Zed** — `Settings → settings.json`:

```json
{
  "agent_servers": {
    "Ghosty": {
      "type": "custom",
      "command": "npx",
      "args": ["-y", "ghosty-acp", "wss://acp-TU-AGENTE.../acp"],
      "env": { "GHOSTY_ACP_TOKEN": "gat_…" }
    }
  }
}
```

**VS Code** — instala la extensión *ACP Client* y pega en `settings.json`:

```json
{
  "acp.agents": {
    "Ghosty": {
      "command": "npx",
      "args": ["-y", "ghosty-acp", "wss://acp-TU-AGENTE.../acp"],
      "env": { "GHOSTY_ACP_TOKEN": "gat_…" }
    }
  }
}
```

No uses «Add Agent» de la barra lateral de VS Code: ese asistente sólo pregunta comando y argumentos, nunca la llave, y el agente queda sin credencial.

**JetBrains y neovim** usan el mismo par comando + argumentos + variable de entorno; consulta cómo declara agentes ACP tu cliente.

## Qué puedes hacer desde el editor

- Hablarle con el **contexto de tu proyecto**: el agente ve los archivos que le compartes.
- Pedirle cambios y **revisar el diff** antes de aplicarlo, como con cualquier agente de código.
- Usar `GHOSTY_ACP_CWD` para fijar el directorio de trabajo remoto.

## El token

Es la llave de tu agente: quien la tenga puede hablar con él y usar su terminal. Va en la **variable de entorno** de la configuración, nunca en los argumentos del comando: cualquier programa de tu máquina puede leer los argumentos de otro. Si crees que se filtró, **rótalo** desde el panel: el anterior muere al instante.

## Cuando algo no funciona

| Síntoma | Causa |
|---|---|
| «rechazado (1006)» | El token no coincide. Si lo rotaste, vuelve a copiar el bloque. |
| Tarda unos segundos en arrancar | Normal: la máquina duerme y la primera conexión la despierta. |
| «ya atiende N conversaciones» | Cada sesión abierta ocupa un sitio. Cierra alguna y vuelve a entrar. |
| El editor se queda callado | El puente escribe en la salida de error. En Zed: *panel del agente → Ver registros*. |