A
ahpio/ahpd
An open-source, plugin-driven AHP server with native Claude and pi agents, ACP agents (Codex, Copilot,…
○checked 2026-11-20 - the package in the command does not match this entry, so it is not shown as a copyable command.
★ 20·updated 2026-11-19
View on GitHub ↗Link checked 2026-11-17 · HTTP 200 · opens the vendor's own site
After install: how to tell it works
- What you see after install — The command exits 0 and the terminal shows no "command not found" or "permission denied".
- One-line self-check — Run the smallest usage example from that repository's README. If the output matches what the README describes, it is working.
- If that does not work — This project has no troubleshooting notes. Search its issues for "install".
The install command comes from the repository; these checks describe observable results only and do not replace the project's own docs.
- Star count
- 20 ★ · ahpio/ahpd · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-16 · last seen 2026-11-20 · seen 5× · listed by 1 sources
- Score
- score 103 · 20 ★ · 1 sources · repo
- Install
- see Install & config above
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Open Source. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
ahpio/ahpd;first catalogued 2026-11-16;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# ahpd - agent host platform
Excerpted from the repository README (abridged)
Run your AI agents anywhere. Control them from anywhere.
ahpd is an open-source server that brings your AI agents, tools, and projects together.
Run agents on your computer, a remote server, or in containers. Connect from your browser, desktop, terminal, or phone.
Your work stays on the server. You can close an app, switch devices, or disconnect without losing your session.
Built on the Agent Host Protocol (AHP). See AHP compatibility for what it implements.
Read the documentation · GitHub · ahpio.com
## Start in minutes
Install with one line on Linux or macOS:
bash
curl -fsSL https://ahpio.com/ahpd/install.sh | bash
On Windows, in PowerShell:
powershell
irm https://ahpio.com/ahpd/install.ps1 | iex
The script checks for Node 22.18 or newer, installs @ahpd/server without sudo, adds ahpd to your PATH, and runs ahpd configure. Install options
Or install with npm, then run the setup:
bash
npm install -g @ahpd/server --allow-scripts=node-pty
ahpd configure
Choose your agents, network settings, and project folders. To add an agent later, run ahpd plugin install @ahpd/agent-claude.
Start the host:
bash
ahpd start --path /work/project
Your host is ready for an AHP client. Connect from the terminal with ahpc:
bash
npx @softov/ahpc --host ws://127.0.0.1:9187
### 🗂️ Serve multiple projects
bash
ahpd --path /work/api --path /work/web
Project paths are catalogue entries, not filesystem sandboxes. Access to other paths depends on the configured host capabilities and permissions.
### 🔐 Connect remotely
By default, the host listens on loopback. To listen on another interface, configure a connection token:
bash
ahpd --host 0.0.0.0 --connection-token-file ~/.config/ahpd/token
Only expose the host to networks you trust, and protect the token. See the remote access documentation.
## Your agents. Your machines. Your control.
AI agents can help you write code, fix problems, manage files, and automate tasks. But they often depend on the terminal or application where you started them.
ahpd gives your agents a place to run and gives you a way to reach them.
⏳ Keep work running
Start a task and leave it running on your host. Your agent can continue its work when you close the client. Return later to review the results.
📱 Work from any device
Start on your desktop. Check progress from your phone. Open the same session in your browser or terminal. Your work stays in sync.
🤖 Choose your agents
Use Claude Code, Codex, Copilot, Gemini, pi, and other supported agents. Configure the agents you need and use them through one host.
🐳 Run work in isolated environments
Use Docker containers to give tasks their own environment. Keep work separate when projects need different tools or dependencies.
⏰ Automate routine tasks
Schedule agent work or start it from a webhook. Let your host run tasks even when no client is connected.
🔐 Control access
Control access to your agents and tools. Define who can interact with your host and what actions they can perform.
📊 Diagnostics
Inspect host status, logs, network information, and telemetry.
💰 Control spending
See what each person, team, and project has spent on models. Set daily, weekly, or monthly limits, and the host refuses new work when a limit is reached.
ahpd is an open-source server that brings your AI agents, tools, and projects together.
Run agents on your computer, a remote server, or in containers. Connect from your browser, desktop, terminal, or phone.
Your work stays on the server. You can close an app, switch devices, or disconnect without losing your session.
Built on the Agent Host Protocol (AHP). See AHP compatibility for what it implements.
Read the documentation · GitHub · ahpio.com
## Start in minutes
Install with one line on Linux or macOS:
bash
curl -fsSL https://ahpio.com/ahpd/install.sh | bash
On Windows, in PowerShell:
powershell
irm https://ahpio.com/ahpd/install.ps1 | iex
The script checks for Node 22.18 or newer, installs @ahpd/server without sudo, adds ahpd to your PATH, and runs ahpd configure. Install options
Or install with npm, then run the setup:
bash
npm install -g @ahpd/server --allow-scripts=node-pty
ahpd configure
Choose your agents, network settings, and project folders. To add an agent later, run ahpd plugin install @ahpd/agent-claude.
Start the host:
bash
ahpd start --path /work/project
Your host is ready for an AHP client. Connect from the terminal with ahpc:
bash
npx @softov/ahpc --host ws://127.0.0.1:9187
### 🗂️ Serve multiple projects
bash
ahpd --path /work/api --path /work/web
Project paths are catalogue entries, not filesystem sandboxes. Access to other paths depends on the configured host capabilities and permissions.
### 🔐 Connect remotely
By default, the host listens on loopback. To listen on another interface, configure a connection token:
bash
ahpd --host 0.0.0.0 --connection-token-file ~/.config/ahpd/token
Only expose the host to networks you trust, and protect the token. See the remote access documentation.
## Your agents. Your machines. Your control.
AI agents can help you write code, fix problems, manage files, and automate tasks. But they often depend on the terminal or application where you started them.
ahpd gives your agents a place to run and gives you a way to reach them.
⏳ Keep work running
Start a task and leave it running on your host. Your agent can continue its work when you close the client. Return later to review the results.
📱 Work from any device
Start on your desktop. Check progress from your phone. Open the same session in your browser or terminal. Your work stays in sync.
🤖 Choose your agents
Use Claude Code, Codex, Copilot, Gemini, pi, and other supported agents. Configure the agents you need and use them through one host.
🐳 Run work in isolated environments
Use Docker containers to give tasks their own environment. Keep work separate when projects need different tools or dependencies.
⏰ Automate routine tasks
Schedule agent work or start it from a webhook. Let your host run tasks even when no client is connected.
🔐 Control access
Control access to your agents and tools. Define who can interact with your host and what actions they can perform.
📊 Diagnostics
Inspect host status, logs, network information, and telemetry.
💰 Control spending
See what each person, team, and project has spent on models. Set daily, weekly, or monthly limits, and the host refuses new work when a limit is reached.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/ahpio-ahpd/)
- Source
- github · https://github.com/ahpio/ahpd
- Browse by field
- Open source
- Traction
- 20 ★
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.