Agent Host Protocol, código aberto

Seus agentes rodam no seu host. Comande de qualquer lugar.

O ahpd roda agentes de código numa máquina que é sua. Comande pelo VS Code, pelo navegador, pelo terminal ou pelo celular. Feche um cliente, abra outro, e a sessão continua lá.

Começarsoftov/ahpdO daemon, o SDK e os plugins

As sessões ficam no host, não no cliente que as iniciou.

Agent Host Protocol

Qualquer cliente. Qualquer agente. Um protocolo.

Rode agentes num host. Conecte de qualquer lugar. Mantenha o controle.

Sessões

Persistentes no host. Reconecte quando quiser, de vários clientes.

Automações

Agende ou dispare execuções de agentes. Acompanhe cada execução.

Agentes

Vários backends de agente, modelos e configurações. Um host.

Controle

Aprove, conduza, enfileire ou cancele. Mesmo no meio do turno.

Depuração

Acesse terminais, arquivos, diffs, logs e traces do OpenTelemetry.

O host

O ahpd roda seus agentes.

Um servidor, SDK e plugins. Rode onde quiser: estação de trabalho, servidor, VM ou container. Os agentes continuam trabalhando mesmo quando os clientes desconectam.

AHP 1.0.0
Protocolo
31 / 32
Comandos
95 / 96
Ações de estado
Node · Bun · Deno
Runtimes
softov/ahpdO daemon, o SDK e os plugins$ npm i -g @ahpd/server

  • Plugins

    Estenda agentes, ferramentas, transportes, esquemas de URI e conectores com --plugin.

  • Qualquer agente, qualquer modelo

    Agentes ACP (Codex, Copilot, Gemini), Claude Code, Pi. Configure APIs e modelos compatíveis com OpenAI com o harness que preferir.

  • Automações

    Execuções agendadas, rodando no host. Nenhum cliente necessário.

  • Computadores isolados

    Rode sessões em containers Docker descartáveis com o @ahpd/computer.

  • Git commit, PR e worktrees

    Um worktree por sessão. Vários agentes, vários repositórios.

  • Interface web

    Adicione um cliente no navegador e um console de administração com o @ahpd/web.

  • Acesso remoto

    Local por padrão. Conexões remotas protegidas por token, com Dev Tunnels opcionais.

O app de celular

O AgentHost Client é um app para o seu celular.

Instale no iOS ou no Android, adicione o endereço e o token do seu host, e suas sessões vão com você. É um cliente: conecta no host que você roda e em mais nada.

  • iOS
  • Android
  • Grátis no acesso antecipado
  • Acompanhe sessões ao vivo e entre quando um agente precisa de uma decisão
  • Confira os arquivos alterados e seus diffs
  • Abra um terminal no host
  • Crie, pause e acompanhe automações
  • Sem conta. O token fica no cofre do aparelho

Em breve na App Store e no Google Play.

Visite agenthostclient.com
A tela de Sessões do app: o que espera por você, sessões em andamento e o histórico recente, agrupados por host.

O cliente de terminal

O ahpc comanda pelo terminal.

Um chat em tela cheia, comandos simples para scripts, ou um servidor de ferramentas que deixa um agente em outro lugar comandar as sessões do seu host.

softov/ahpcO cliente de terminal$ npm i -g @softov/ahpc
Uma sessão no ahpc: a conversa, com o modelo, o modo de permissão e o workspace no cabeçalho.A lista de sessões do ahpc: cada sessão com status, agente, workspace e branch.

Sessões e turnos. Crie, configure e arquive sessões, envie prompts, acompanhe as respostas, enfileire continuações.

Responda ao agente. Aprove ou negue chamadas de ferramenta e responda perguntas no meio do turno.

Para scripts. Todo comando aceita --json, e o servidor de ferramentas fala MCP.

Instale e aponte para um host

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

Começar

Rode o ahpd em quatro passos.

Você precisa do Node 22 ou mais novo, ou Bun, ou Deno. O ahpd não traz nenhum agente: você escolhe os backends ao configurar.

  1. 1

    Instale o daemon

    Ou rode sem instalar, com npx @ahpd/server.

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

    Configure

    Pergunta os backends de agente, o endereço, a porta, o token e as pastas, e grava ~/.config/ahpd/config.json. Rode de novo para mudar uma resposta.

    $ ahpd configure
  3. 3

    Inicie

    Em primeiro plano, ou desanexado com ahpd start para continuar rodando depois que o terminal fecha. Adicione um backend depois com ahpd plugin install.

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

    Conecte um cliente

    O token fica em ~/.config/ahpd/connection-token. Use o ahpc, o app, ou o VS Code por chat.remoteAgentHosts.

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

Fora da sua rede: o ahpd escuta só em loopback e recusa qualquer outro endereço sem token. Mesmo com token, coloque o host numa VPN mesh ou num túnel TLS, nunca numa porta exposta direto: o que estiver atrás dela pode ler e gravar seus arquivos com o seu usuário.