ACP — conecta tu editor

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.

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:

{  "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:

{  "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