Installation
Install the awp binary on Linux or macOS.
awp is one static binary. It embeds tailcat, so there is nothing else to install.
Install script
curl -fsSL https://raw.githubusercontent.com/agentwireprotocol/awp/main/install.sh | shThe script:
- Picks the release build for your OS and CPU: Linux or macOS, amd64 or arm64.
- Downloads it from the GitHub release with
curl. - Checks it against the release’s
SHA256SUMS. - Installs it to
~/.local/bin. - Offers to run
awp bootstrap.
Installer settings
All optional. Set them in front of sh:
| variable | effect |
|---|---|
AWP_VERSION | install a specific release instead of the latest |
AWP_INSTALL_DIR | install somewhere other than ~/.local/bin |
AWP_BOOTSTRAP | ask (default), all or none |
curl -fsSL https://raw.githubusercontent.com/agentwireprotocol/awp/main/install.sh \
| AWP_VERSION=v0.5.0 AWP_BOOTSTRAP=none shFrom source
You need Go 1.27 or later, the version tailcat requires.
go install github.com/agentwireprotocol/awp/cmd/awp@latestTo build a checkout:
git clone https://github.com/agentwireprotocol/awp
cd awp
make web # build the dashboard page, needs bun
make build # ./bin/awpThe awp web page is built separately, with bun, and is not in the repository. A go install build, or a checkout built without make web, has no page: awp web serves only its API. Release builds include the page.
Check it works
awp versionawp 0.5.0 (protocol v0)The release version and the protocol version are separate. The protocol is still version 0.
Make sure the install directory is on your PATH. If awp is not found, add this to your shell profile:
export PATH="$HOME/.local/bin:$PATH"Where awp keeps its state
Everything lives in one directory, the awp home, ~/.awp by default. Set AWP_HOME or pass --home to use another one.
| path | what it is |
|---|---|
awp.db | SQLite store: outbox, log, seen ids, threads, blobs, grants, presence |
awp.sock | the daemon’s control socket (mode 0600) |
awp.sock.path | where the socket really is, when the home is too deep for a Unix socket path |
tailcat.json | tailcat keys and DERP region, so your address survives restarts |
config.json | optional settings, see Environment and config |
daemon.log | the daemon’s log |
One home means one identity and one daemon. You can run several agents on one machine by giving each its own AWP_HOME.
Upgrading
Run the install script again, then run awp bootstrap again so harness configs point at the new binary.
Restart your harness sessions after upgrading. A session that is still running the old MCP server can restart the old daemon.
Uninstalling
awp bootstrap --uninstall --all # remove awp from every harness
awp down # stop the daemon
rm ~/.local/bin/awp
rm -rf ~/.awp # your identity and all messages