Agent Host Protocol, código abierto

Tus agentes corren en tu host. Contrólalos desde cualquier lugar.

ahpd ejecuta agentes de código en una máquina tuya. Contrólalos desde VS Code, el navegador, la terminal o el móvil. Cierra un cliente, abre otro, y la sesión sigue ahí.

Empezarsoftov/ahpdEl daemon, el SDK y los plugins

Las sesiones viven en el host, no en el cliente que las inició.

Agent Host Protocol

Cualquier cliente. Cualquier agente. Un protocolo.

Ejecuta agentes en un host. Conéctate desde cualquier lugar. Mantén el control.

Sesiones

Persistentes en el host. Reconéctate cuando quieras, desde varios clientes.

Automatizaciones

Programa o dispara ejecuciones de agentes. Sigue cada ejecución.

Agentes

Varios backends de agente, modelos y configuraciones. Un host.

Control

Aprueba, dirige, encola o cancela. Incluso a mitad del turno.

Depuración

Accede a terminales, archivos, diffs, logs y trazas de OpenTelemetry.

El host

ahpd ejecuta tus agentes.

Un servidor, SDK y plugins. Ejecútalo donde quieras: estación de trabajo, servidor, VM o contenedor. Los agentes siguen trabajando aunque los clientes se desconecten.

AHP 1.0.0
Protocolo
31 / 32
Comandos
95 / 96
Acciones de estado
Node · Bun · Deno
Runtimes
softov/ahpdEl daemon, el SDK y los plugins$ npm i -g @ahpd/server

  • Plugins

    Extiende agentes, herramientas, transportes, esquemas de URI y conectores con --plugin.

  • Cualquier agente, cualquier modelo

    Agentes ACP (Codex, Copilot, Gemini), Claude Code, Pi. Configura APIs y modelos compatibles con OpenAI con tu harness preferido.

  • Automatizaciones

    Ejecuciones programadas, en el host. Sin necesidad de cliente.

  • Computadoras aisladas

    Ejecuta sesiones en contenedores Docker desechables con @ahpd/computer.

  • Git commit, PR y worktrees

    Un worktree por sesión. Varios agentes, varios repositorios.

  • Interfaz web

    Añade un cliente de navegador y una consola de administración con @ahpd/web.

  • Acceso remoto

    Local por defecto. Conexiones remotas protegidas por token, con Dev Tunnels opcionales.

La app móvil

AgentHost Client es una app para tu móvil.

Instálala en iOS o Android, añade la dirección y el token de tu host, y tus sesiones van contigo. Es un cliente: se conecta al host que ejecutas y a nada más.

  • iOS
  • Android
  • Gratis en acceso anticipado
  • Sigue sesiones en vivo y entra cuando un agente necesita una decisión
  • Revisa los archivos que cambiaron y sus diffs
  • Abre una terminal en el host
  • Crea, pausa y sigue automatizaciones
  • Sin cuenta. El token se queda en el almacén seguro del dispositivo

Próximamente en la App Store y Google Play.

Visita agenthostclient.com
La pantalla de Sesiones de la app: lo que te espera, sesiones en curso e historial reciente, agrupados por host.

El cliente de terminal

ahpc los controla desde la terminal.

Un chat a pantalla completa, comandos simples para scripts, o un servidor de herramientas que deja a un agente en otro lugar controlar las sesiones de tu host.

softov/ahpcEl cliente de terminal$ npm i -g @softov/ahpc
Una sesión en ahpc: la conversación, con el modelo, el modo de permisos y el workspace en la cabecera.La lista de sesiones de ahpc: cada sesión con su estado, agente, workspace y rama.

Sesiones y turnos. Crea, configura y archiva sesiones, envía prompts, sigue las respuestas, encola continuaciones.

Responde al agente. Aprueba o deniega llamadas a herramientas y contesta preguntas a mitad del turno.

Para scripts. Cada comando acepta --json, y el servidor de herramientas habla MCP.

Instálalo y apúntalo a un host

$ ahpc --host ws://127.0.0.1:9187

Empezar

Ejecuta ahpd en cuatro pasos.

Necesitas Node 22 o más reciente, o Bun, o Deno. ahpd no trae ningún agente: eliges los backends al configurarlo.

  1. 1

    Instala el daemon

    O ejecútalo sin instalar, con npx @ahpd/server.

    $ npm i -g @ahpd/server
  2. 2

    Configúralo

    Pregunta los backends de agente, la dirección, el puerto, el token y las carpetas, y escribe ~/.config/ahpd/config.json. Ejecútalo otra vez para cambiar una respuesta.

    $ ahpd configure
  3. 3

    Arráncalo

    En primer plano, o desacoplado con ahpd start para que siga corriendo al cerrar la terminal. Añade un backend después con ahpd plugin install.

    $ ahpd start --path /work/project
  4. 4

    Conecta un cliente

    El token está en ~/.config/ahpd/connection-token. Usa ahpc, la app, o VS Code mediante chat.remoteAgentHosts.

    $ ahpc --host ws://127.0.0.1:9187

Fuera de tu red: ahpd escucha solo en loopback y rechaza cualquier otra dirección sin token. Aun con token, pon el host en una VPN mesh o un túnel TLS, nunca en un puerto expuesto directamente: lo que esté detrás puede leer y escribir tus archivos como tu usuario.