The AgentX daemon runs on your own machine and hosts your agents there. Install it, claim it from your console, and it joins your account's fleet — every agent, session, and artifact driven from one screen.
Native macOS builds for Apple Silicon and Intel install from the AgentX Homebrew tap. You need Homebrew first.
brew install agentxhq/tap/agentxInstalls agentx-daemon, agentx, and the agentx-browser symlink.
State lives under ~/.agentx/.
agentx-daemon background
agentx-daemon status
open http://127.0.0.1:3333/consoleOr run at login with brew services start agentx.
These builds are not yet signed or notarized. Homebrew installs them without a Gatekeeper prompt. Prefer containers instead? Docker on Mac →
Native Windows packages are not the main path yet. Run the same Linux daemon image with Docker Desktop (WSL 2) — full steps on the Docker install page.
Pick one package — desktop and server conflict; install only one.
agentx-desktop). Login-user workstation. Runs as a user unit
(agentx-daemon.service) with linger so it stays up after logout.agentx-server). Headless / always-on host. Runs as the system
unit agentx.service as root so you can run agents over multiple users.wget https://app.agentxhq.io/releases/agentx-desktop_0.99.0_amd64.debecho "c944967efd1a70bbc4b921923ccfca415d331f388fd6ac5a793a9ee001d9de9d agentx-desktop_0.99.0_amd64.deb" | sha256sum --checkOnly continue when the checker prints agentx-desktop_0.99.0_amd64.deb: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo apt install ./agentx-desktop_0.99.0_amd64.debapt resolves dependencies and installs the desktop package (user unit + linger).
Pure root install: set AGENTX_DESKTOP_USER=yourlogin before apt.
wget https://app.agentxhq.io/releases/agentx-desktop_0.99.0_arm64.debecho "c4d662fc38af2b423e91210924c759e79904bf8b617f52c3b7178067fe922459 agentx-desktop_0.99.0_arm64.deb" | sha256sum --checkOnly continue when the checker prints agentx-desktop_0.99.0_arm64.deb: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo apt install ./agentx-desktop_0.99.0_arm64.debapt resolves dependencies and installs the desktop package (user unit + linger).
Pure root install: set AGENTX_DESKTOP_USER=yourlogin before apt.
wget https://app.agentxhq.io/releases/agentx-server_0.99.0_amd64.debecho "777bd18b37981788cc5dc009b94822c4d1f2fb3183d2ae8e338f59f6c7703e26 agentx-server_0.99.0_amd64.deb" | sha256sum --checkOnly continue when the checker prints agentx-server_0.99.0_amd64.deb: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo apt install ./agentx-server_0.99.0_amd64.debapt resolves the package's dependencies and installs the daemon.
wget https://app.agentxhq.io/releases/agentx-server_0.99.0_arm64.debecho "24db15fc094155909745d818e04cc26dbbbffdfc252e4baba642b97f9c2cb729 agentx-server_0.99.0_arm64.deb" | sha256sum --checkOnly continue when the checker prints agentx-server_0.99.0_arm64.deb: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo apt install ./agentx-server_0.99.0_arm64.debapt resolves the package's dependencies and installs the daemon.
wget https://app.agentxhq.io/releases/agentx-desktop-0.99.0-1-x86_64.pkg.tar.zstecho "0469d73a63cd071a82e2b3a4efaa3e5969f689e65661f1b3b2b6ebf4ebda4110 agentx-desktop-0.99.0-1-x86_64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-desktop-0.99.0-1-x86_64.pkg.tar.zst: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo AGENTX_DESKTOP_USER="$USER" pacman -U ./agentx-desktop-0.99.0-1-x86_64.pkg.tar.zstSets the desktop user explicitly (pacman as root often has an empty SUDO_USER),
then installs the package and enables the user unit with linger.
wget https://app.agentxhq.io/releases/agentx-desktop-0.99.0-1-aarch64.pkg.tar.zstecho "e55b315e083c5a92a9f07b1233c59986a4e842a91bfdbc1acf5c461beaf70411 agentx-desktop-0.99.0-1-aarch64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-desktop-0.99.0-1-aarch64.pkg.tar.zst: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo AGENTX_DESKTOP_USER="$USER" pacman -U ./agentx-desktop-0.99.0-1-aarch64.pkg.tar.zstSets the desktop user explicitly (pacman as root often has an empty SUDO_USER),
then installs the package and enables the user unit with linger.
wget https://app.agentxhq.io/releases/agentx-server-0.99.0-1-x86_64.pkg.tar.zstecho "242f9a922ea09ba66208df0c54634db9f75cad6068aeddcd881b598cb0196902 agentx-server-0.99.0-1-x86_64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-server-0.99.0-1-x86_64.pkg.tar.zst: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo pacman -U ./agentx-server-0.99.0-1-x86_64.pkg.tar.zstInstalls the package and enables the matching systemd unit.
wget https://app.agentxhq.io/releases/agentx-server-0.99.0-1-aarch64.pkg.tar.zstecho "74a092a1d58f762872817ee2510c2d9bf00be5ca577caf8fca1da8730fc2660c agentx-server-0.99.0-1-aarch64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-server-0.99.0-1-aarch64.pkg.tar.zst: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo pacman -U ./agentx-server-0.99.0-1-aarch64.pkg.tar.zstInstalls the package and enables the matching systemd unit.
No package is available for this OS / distro / flavor / architecture combination in the current release feed. Try another selection, or check back after the next publish.
After install, start the daemon if it is not already running.
Linux packages enable systemd automatically (server: system unit
agentx.service; desktop: user unit agentx-daemon.service
with linger). On Mac with Homebrew, run agentx-daemon background
or brew services start agentx. Then claim it so it joins your tenant fleet:
:3334). While enrollment is pending, it shows a claim code and a claim link./daemons/claim?code=… on your AgentX host.Once your daemon is enrolled, your agents, sessions, and artifacts are live in the console — create named agents, put them in a Bubble, and set them to work.