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.142.0_amd64.debecho "5201e7274ea53cd3b39dde8ae6fb7628d3d2540d6a08e7eb52bb71801b296663 agentx-desktop_0.142.0_amd64.deb" | sha256sum --checkOnly continue when the checker prints agentx-desktop_0.142.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.142.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.142.0_arm64.debecho "3a49064abe384a608f1a29f7f1a26b352b0fb5ff8f54a45414bfe1e7492e4a64 agentx-desktop_0.142.0_arm64.deb" | sha256sum --checkOnly continue when the checker prints agentx-desktop_0.142.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.142.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.142.0_amd64.debecho "572e40e3f1236b652ecec2df5b971ebb869b7cd141e472f65af592824d0bf09a agentx-server_0.142.0_amd64.deb" | sha256sum --checkOnly continue when the checker prints agentx-server_0.142.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.142.0_amd64.debapt resolves the package's dependencies and installs the daemon.
wget https://app.agentxhq.io/releases/agentx-server_0.142.0_arm64.debecho "680392c489c2c9cb8422bbd35c84c04dccb05e352c05ff60e47b0491f846d78d agentx-server_0.142.0_arm64.deb" | sha256sum --checkOnly continue when the checker prints agentx-server_0.142.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.142.0_arm64.debapt resolves the package's dependencies and installs the daemon.
wget https://app.agentxhq.io/releases/agentx-desktop-0.142.0-1-x86_64.pkg.tar.zstecho "0a18853fef751c1212589f971f6524dd1036de5ebb3fd2fe049e1e7cd59e562b agentx-desktop-0.142.0-1-x86_64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-desktop-0.142.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.142.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.142.0-1-aarch64.pkg.tar.zstecho "9b6db00e440d08733b847551728efc6eeddae3715bc3f32ba0c85745adfa9338 agentx-desktop-0.142.0-1-aarch64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-desktop-0.142.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.142.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.142.0-1-x86_64.pkg.tar.zstecho "6a3aaca1e5a9fd314a9040b5c58f377d84cd4639490a8daca1553f2a0d84e60c agentx-server-0.142.0-1-x86_64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-server-0.142.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.142.0-1-x86_64.pkg.tar.zstInstalls the package and enables the matching systemd unit.
wget https://app.agentxhq.io/releases/agentx-server-0.142.0-1-aarch64.pkg.tar.zstecho "29592b70b290b7d918970a75a4e8c2810ec945f82795ce59e13bc2a7a7ee850c agentx-server-0.142.0-1-aarch64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-server-0.142.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.142.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.