Paste this prompt into Claude Code on the machine where AgentX should run, in a terminal or in the Claude desktop app. Codex or another coding agent on that machine works too. A web chat such as claude.ai can't install anything on your machine. The agent installs the daemon, sets up the agent CLIs and gives you your claim link. Prefer to do it by hand? The manual steps are below.
Help me install AgentX on my own computer or server.
Read https://www.agentxhq.com/install.md and follow it.
When you're done, give me my claim link.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.
No Homebrew? Don't install it just for AgentX. Use the package for your Mac: uname -m prints arm64 on Apple Silicon and x86_64 on Intel. install.sh puts agentx-daemon and agentx in ~/.local/bin (no sudo) and starts the daemon now and at every login.
curl -fLO https://app.agentxhq.io/releases/agentx-0.175.3-darwin-arm64.tar.gzecho "bfd2252ced8cb28709d009efd86882cee1822a3f1d0dbc03b4bae84394f1b12b agentx-0.175.3-darwin-arm64.tar.gz" | shasum -a 256 -cOnly continue when the checker prints agentx-0.175.3-darwin-arm64.tar.gz: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
tar xzf agentx-0.175.3-darwin-arm64.tar.gz && cd agentx-0.175.3-darwin-arm64 && ./install.sh --launchdcurl -fLO https://app.agentxhq.io/releases/agentx-0.175.3-darwin-amd64.tar.gzecho "15e3bfcf74c6c0fee5ad81b98b677dc9274686ec4a2255f04c0718cfd2a576d8 agentx-0.175.3-darwin-amd64.tar.gz" | shasum -a 256 -cOnly continue when the checker prints agentx-0.175.3-darwin-amd64.tar.gz: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
tar xzf agentx-0.175.3-darwin-amd64.tar.gz && cd agentx-0.175.3-darwin-amd64 && ./install.sh --launchdDownloaded it in a browser instead? Run this in the unpacked folder before ./install.sh: xattr -dr com.apple.quarantine .
These builds are not yet signed or notarized. Homebrew installs them without a Gatekeeper prompt. Prefer containers instead? Docker on Mac →
Windows 10 and 11 (x64). The zip holds agentx-daemon, the agentx CLI and agentx-browser, signed by My Server Guy ApS. The daemon runs as a Windows service under your own account.
Download the zip, then check it in PowerShell. Continue only if it prints True.
curl.exe -fLO https://app.agentxhq.io/releases/agentx-windows-amd64_0.175.3.zip
(Get-FileHash .\agentx-windows-amd64_0.175.3.zip -Algorithm SHA256).Hash -eq '2f8462ac478e45d8a45deec07a0a9fd03b54040bb62cc34067b69ac9b1522705'Unpack it:
Expand-Archive .\agentx-windows-amd64_0.175.3.zip -DestinationPath .In PowerShell as administrator, first cd to the folder you downloaded the zip to (an administrator PowerShell opens in C:\Windows\System32), then copy the programs and register the service:
New-Item -ItemType Directory -Force 'C:\Program Files\AgentX' | Out-Null
Copy-Item .\agentx-windows-v*\*.exe 'C:\Program Files\AgentX\' -Force
New-Service -Name AgentX -BinaryPathName '"C:\Program Files\AgentX\agentx-daemon.exe" serve' -StartupType ManualMake it run as you: open services.msc, double-click AgentX, and on the Log On tab choose This account, with your Windows account and password. With a Microsoft account, use its password, not your PIN.
Start it. It then starts with Windows:
Set-Service AgentX -StartupType Automatic
Start-Service AgentX
Get-Service AgentXPrefer containers? 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.175.3_amd64.debecho "4a278cbed5cbe9e300ef17664981e676b037516b0becb707a934a023474fb2a0 agentx-desktop_0.175.3_amd64.deb" | sha256sum --checkOnly continue when the checker prints agentx-desktop_0.175.3_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.175.3_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.175.3_arm64.debecho "dd774628880a84eb46f62d55f77c4d9850bae4c81b521c6c533ead1119d3fe58 agentx-desktop_0.175.3_arm64.deb" | sha256sum --checkOnly continue when the checker prints agentx-desktop_0.175.3_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.175.3_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.175.3_amd64.debecho "9b61b15a36a5e6b7ca286030eb233f37da327daddcf506495605b7c1314878e3 agentx-server_0.175.3_amd64.deb" | sha256sum --checkOnly continue when the checker prints agentx-server_0.175.3_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.175.3_amd64.debapt resolves the package's dependencies and installs the daemon.
wget https://app.agentxhq.io/releases/agentx-server_0.175.3_arm64.debecho "9f5ee28af99f3e0210140b6c5b2b346cdd914fcba9d3f3c6f400354b33b041ad agentx-server_0.175.3_arm64.deb" | sha256sum --checkOnly continue when the checker prints agentx-server_0.175.3_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.175.3_arm64.debapt resolves the package's dependencies and installs the daemon.
wget https://app.agentxhq.io/releases/agentx-desktop-0.175.3-1-x86_64.pkg.tar.zstecho "7a423f20c317f4ac6ccfb591a221094317ed8c8a243f358e54a8d698fe2ad30b agentx-desktop-0.175.3-1-x86_64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-desktop-0.175.3-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.175.3-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.175.3-1-aarch64.pkg.tar.zstecho "23c50df0298e515a1da12a3513772276402768a4b87c127afdd8ba6988537927 agentx-desktop-0.175.3-1-aarch64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-desktop-0.175.3-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.175.3-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.175.3-1-x86_64.pkg.tar.zstecho "d89a35b4ce0220437698fb0ca80a35d74945cf9e2c18448076d814f12d7b5840 agentx-server-0.175.3-1-x86_64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-server-0.175.3-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.175.3-1-x86_64.pkg.tar.zstInstalls the package and enables the matching systemd unit.
wget https://app.agentxhq.io/releases/agentx-server-0.175.3-1-aarch64.pkg.tar.zstecho "8bef6ddcf4cfc8ba7e37ab21d14002e071357e4a6cdd26bd03759c8ae70aec5b agentx-server-0.175.3-1-aarch64.pkg.tar.zst" | sha256sum --checkOnly continue when the checker prints agentx-server-0.175.3-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.175.3-1-aarch64.pkg.tar.zstInstalls the package and enables the matching systemd unit.
wget https://app.agentxhq.io/releases/agentx-desktop-0.175.3-1.x86_64.rpmecho "3f9f88686e8c579e42526539f84225bac4da0dad1ff3879812f6da0c0cd8541c agentx-desktop-0.175.3-1.x86_64.rpm" | sha256sum --checkOnly continue when the checker prints agentx-desktop-0.175.3-1.x86_64.rpm: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo dnf install ./agentx-desktop-0.175.3-1.x86_64.rpmwget https://app.agentxhq.io/releases/agentx-desktop-0.175.3-1.aarch64.rpmecho "18a0b206c53f61bea29053f8456575029527424aec5d5a772419a6a79b3b7ded agentx-desktop-0.175.3-1.aarch64.rpm" | sha256sum --checkOnly continue when the checker prints agentx-desktop-0.175.3-1.aarch64.rpm: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo dnf install ./agentx-desktop-0.175.3-1.aarch64.rpmwget https://app.agentxhq.io/releases/agentx-server-0.175.3-1.x86_64.rpmecho "28f26c6cc02a5e2717bda3ee41b7a43aa55b5112847dd63f213869c9dbb63186 agentx-server-0.175.3-1.x86_64.rpm" | sha256sum --checkOnly continue when the checker prints agentx-server-0.175.3-1.x86_64.rpm: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo dnf install ./agentx-server-0.175.3-1.x86_64.rpmwget https://app.agentxhq.io/releases/agentx-server-0.175.3-1.aarch64.rpmecho "74edcd02a5369734653268a0112ebbb550a1d8fa0395809d073f9fcb58d3da9f agentx-server-0.175.3-1.aarch64.rpm" | sha256sum --checkOnly continue when the checker prints agentx-server-0.175.3-1.aarch64.rpm: OK. A failed check means the download is corrupt or isn't the file we published — don't install it.
sudo dnf install ./agentx-server-0.175.3-1.aarch64.rpmNo 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 Chat, and set them to work.