ACP (agentes de IDE)

El Agent Client Protocol (ACP) es un estándar abierto que permite que editores e IDEs hablen con agentes de código por JSON-RPC sobre stdio — el cliente lanza al agente como subproceso y transmite prompts, actividad de herramientas y pedidos de permiso a través de él. Zed, los IDEs de JetBrains y una lista creciente de clientes (marimo, Toad, extensiones de VS Code) hablan ACP.

apx acp convierte al super-agente de APX en un agente ACP. Sea cual sea tu editor, el agente de atrás es el mismo que responde por Telegram, el panel web y apx code — mismos engines, mismas herramientas, misma memoria.

apx acp

El comando sirve el protocolo por stdin/stdout hasta que el cliente cierra el pipe. Nunca lo ejecutás a mano en una terminal — lo lanza tu editor. Como toda superficie, es un adaptador fino sobre el daemon local (que arranca solo en el primer uso): cada prompt se vuelve un turno streaming del super-agente en el canal code, así que las sesiones ACP reciben el system prompt de codificación y el set de herramientas de git/código.

Conectar desde Zed

Instalá APX global para que apx esté en tu PATH.

Agregá una entrada agent_servers a tu settings.json de Zed:

{
  "agent_servers": {
    "APX": {
      "command": "apx",
      "args": ["acp"]
    }
  }
}

Abrí el Agent Panel, elegí APX y chateá. Las llamadas a herramientas se transmiten al panel, y cualquier acción que necesite confirmación muestra el diálogo nativo de Zed de Permitir / Rechazar.

Qué implementa la superficie

Concepto ACP	Comportamiento en APX
`initialize`	Versión de protocolo `1`; declara `loadSession: false`, sin prompts de imagen/audio/embeddedContext, sin passthrough de MCP
`session/new`	Resuelve el proyecto APC para el `cwd` del cliente y lo registra en el daemon si hace falta
`session/prompt`	Transmite un turno del super-agente; las respuestas resuelven con `stopReason: "end_turn"`
`session/update`	`agent_message_chunk` para texto, `tool_call` / `tool_call_update` para actividad de herramientas
`session/request_permission`	Se emite cuando el modo de permisos de APX exige confirmación; Permitir/Rechazar responde la acción pendiente
`session/cancel`	Aborta el turno en vuelo y lo resuelve con `stopReason: "cancelled"`

El contexto multi-turno se guarda en memoria por sesión: cada turno completado alimenta al siguiente como historial de conversación, así que los prompts de seguimiento recuerdan el hilo sin configuración extra.