AgentX

Language

Choose the language for the AgentX website.

Appearance

Choose how the AgentX website looks.

From zero to working agents, on your machine.

Install AgentX on a computer you own, connect it to your account, and run every agent from one screen. About ten minutes.

Let your coding agent install it

Recommended · the fastest way
  1. Copy this prompt

    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.
    Instructions for AI assistants (install.md)
  2. Paste it into your agent

    Use a coding agent on the machine where AgentX should run. A web chat like claude.ai can't install software.

    • Claude
    • Codex
    • Cursor
    • Grok CLI
    • Junie
    • Mistral Vibe
    • OpenCode
    • Pi
  3. Open your claim link

    Your agent finishes with a link. Open it, and the machine joins your account.

    https://www.agentxhq.com/daemons/claim?code=7KQ-29X laptop connected
Install it yourselfCopy a few commands. Native packages for Linux, Mac and Windows, plus Docker.

Manual install, step by step.

AgentX runs on your own computer and hosts your agents there. Install it, connect it from your console, and it joins your account.

Stable 0.195.1 · published 2026-11-10

  1. 1

    What you need first

    • A machine you control. Native packages for Debian/Ubuntu, Arch and RHEL/Rocky/Alma, for Mac with or without Homebrew, and Desktop and Server installers for Windows 10 and 11 (x64). Docker works everywhere too.
    • An AgentX account. Create one free. No card needed.
    • Your own agent CLIs. Claude, Codex, Cursor, Grok CLI, Junie, Mistral Vibe, OpenCode or Pi, whichever you already use, signed in with your own account. The first session asks you to log in once. OpenCode can also run a local model through Ollama, so your prompts never go to a model provider. How to install and log in to each
  2. 2

    Install AgentX

    Install only one of the two.

    Not sure? Apple menu → About This Mac. “Apple M1” or later means Apple Silicon.

    Install only one: desktop and server packages conflict. Server runs as root so agents can work across multiple users.

    Homebrew and the package without Homebrew run AgentX as the logged-in user, and the agents run as that same user. That install does not run agents as other accounts.

    Mac with Homebrew
    1 · Install
    brew install agentxhq/tap/agentx

    Installs agentx-daemon, agentx and the agentx-browser symlink. State lives under ~/.agentx/.

    2 · Start AgentX
    agentx-daemon background
    agentx-daemon status
    open http://127.0.0.1:3333/console

    Or start it at every login with: brew services start agentx

    Mac without Homebrew · Apple Silicon (arm64)Or download agentx 0.195.1 directly · 28M
    1 · Download
    curl -fLO https://app.agentxhq.io/releases/agentx-0.195.1-darwin-arm64.tar.gz
    2 · Check the download
    echo "1f1d53b6db453d4e2be60b0aa83022c93edc04ab45c9444aea1c3e668b2858ec  agentx-0.195.1-darwin-arm64.tar.gz" | shasum -a 256 -c

    Only continue when it prints agentx-0.195.1-darwin-arm64.tar.gz: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    tar xzf agentx-0.195.1-darwin-arm64.tar.gz && cd agentx-0.195.1-darwin-arm64 && ./install.sh --launchd

    Puts agentx-daemon and agentx in ~/.local/bin (no sudo) and starts AgentX now and at every login.

    Downloaded it in a browser instead? Run xattr -dr com.apple.quarantine . in the unpacked folder first. These builds are not yet signed or notarized; Homebrew installs them without a Gatekeeper prompt.

    Mac without Homebrew · Intel (amd64)Or download agentx 0.195.1 directly · 30M
    1 · Download
    curl -fLO https://app.agentxhq.io/releases/agentx-0.195.1-darwin-amd64.tar.gz
    2 · Check the download
    echo "0df5874a26572a729a820baef8e3f2c1038fe066861799ff089498818a9f7454  agentx-0.195.1-darwin-amd64.tar.gz" | shasum -a 256 -c

    Only continue when it prints agentx-0.195.1-darwin-amd64.tar.gz: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    tar xzf agentx-0.195.1-darwin-amd64.tar.gz && cd agentx-0.195.1-darwin-amd64 && ./install.sh --launchd

    Puts agentx-daemon and agentx in ~/.local/bin (no sudo) and starts AgentX now and at every login.

    Downloaded it in a browser instead? Run xattr -dr com.apple.quarantine . in the unpacked folder first. These builds are not yet signed or notarized; Homebrew installs them without a Gatekeeper prompt.

    Mac · Docker Desktop

    Install Docker Desktop for Mac. Open the Terminal app once Docker reports running.

    1 · Pull the image
    docker pull --platform linux/amd64 agentxhq/agentx-daemon:latest
    2 · Run it
    docker run -d --platform linux/amd64 --name agentx --restart unless-stopped \
      -p 127.0.0.1:3333:3333 \
      -v agentx-data:/var/lib/agentx \
      -v agentx-root:/root \
      -v agentx-home:/home \
      agentxhq/agentx-daemon:latest

    This pins nothing yet. To use a fixed version, replace :latest with a tag from Docker Hub.

    Using a port other than 3333? Add -e AGENTX_SURFACES_WEB_PUBLIC_URL_OVERRIDE=http://127.0.0.1:<port> so the claim link sends you back to the right address.

    3 · Open the console
    open http://127.0.0.1:3333/console

    Or browse to http://127.0.0.1:3333/console. To watch the logs: docker logs -f agentx

    Windows 10 / 11 · x64 · Desktop installerOr download agentx-desktop 0.195.1 directly · 64M

    For the computer you sign in to. It installs for you alone, with no administrator prompt. AgentX runs as you while you are signed in, and your agents use your own Claude and other CLI logins. The installer is signed by My Server Guy ApS.

    1 · Download and check the installer (PowerShell)
    curl.exe -fLO https://app.agentxhq.io/releases/agentx-desktop_0.195.1_amd64.msi
    (Get-FileHash .\agentx-desktop_0.195.1_amd64.msi -Algorithm SHA256).Hash -eq 'ce9472f47e8f9d8d99f8797ad64d80fcbf07c84d8be1abcb3a31825fe100dda1'

    Only continue when it prints True. Anything else means the file is damaged or isn't ours, so don't install it.

    2 · Install it (PowerShell, no administrator needed)
    msiexec /i "$PWD\agentx-desktop_0.195.1_amd64.msi" /l*v agentx-install.log

    Or double-click the file. When it finishes, AgentX starts and your browser opens its claim page. AgentX starts again each time you sign in.

    3 · Connect it to your account

    Your browser opens the claim page. If it didn't, follow the steps below.

    To upgrade, download the newer installer and run it the same way. AgentX keeps its connection to your account, your agents and their files.

    To remove AgentX, uninstall AgentX in Settings › Apps. Your AgentX files stay in %USERPROFILE%\.agentx.

    Windows 10 / 11 · x64 · Server installerOr download agentx-server 0.195.1 directly · 43M

    For a computer that is always on. It installs for the whole computer, with one administrator prompt. AgentX runs as a Windows service, keeps running when nobody is signed in, and runs each agent as its own Windows user. The installer is signed by My Server Guy ApS.

    1 · Download and check the installer (PowerShell)
    curl.exe -fLO https://app.agentxhq.io/releases/agentx-server_0.195.1_amd64.msi
    (Get-FileHash .\agentx-server_0.195.1_amd64.msi -Algorithm SHA256).Hash -eq 'e546a3ddb15e1d7f1a9c70b47631977b553346abe8ed06180ddd3cd791e813f3'

    Only continue when it prints True. Anything else means the file is damaged or isn't ours, so don't install it.

    2 · Install it (PowerShell as administrator)
    msiexec /i "$PWD\agentx-server_0.195.1_amd64.msi" /l*v agentx-install.log

    Or double-click the file and accept the administrator prompt. When it finishes, the AgentX service is running and starts with Windows, and your browser opens its claim page.

    3 · Connect it to your account

    Your browser opens the claim page. If it didn't, follow the steps below.

    On a server without a browser, print the claim link in PowerShell as administrator:
    (Get-Content C:\ProgramData\AgentX\router-state.json | ConvertFrom-Json).claim_url

    To upgrade, download the newer installer and run it the same way. AgentX keeps its connection to your account, your agents and their files.

    To remove AgentX, uninstall AgentX Server in Settings › Apps. That also removes the AgentX service. Your AgentX files stay in C:\ProgramData\AgentX.

    Windows · Docker Desktop

    Install Docker Desktop for Windows with the WSL 2 backend enabled. Use PowerShell or Windows Terminal once Docker reports running.

    Docker on Windows · PowerShellagentxhq/agentx-daemon on Docker Hub
    1 · Pull the image
    docker pull --platform linux/amd64 agentxhq/agentx-daemon:latest
    2 · Run it
    docker run -d --platform linux/amd64 --name agentx --restart unless-stopped `
      -p 127.0.0.1:3333:3333 `
      -v agentx-data:/var/lib/agentx `
      -v agentx-root:/root `
      -v agentx-home:/home `
      agentxhq/agentx-daemon:latest

    The backticks continue the line in PowerShell. In cmd.exe, put it on one line or use ^ instead.

    Using a port other than 3333? Add -e AGENTX_SURFACES_WEB_PUBLIC_URL_OVERRIDE=http://127.0.0.1:<port> so the claim link sends you back to the right address.

    3 · Open the console
    start http://127.0.0.1:3333/console

    Or browse to http://127.0.0.1:3333/console. To watch the logs: docker logs -f agentx

    Debian / Ubuntu · agentx-desktop · amd64Or download agentx-desktop 0.195.1 directly · 32M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-desktop_0.195.1_amd64.deb
    2 · Check the download
    echo "7f40062f4b577d7c13f915c070b038d4b7898d008b3bcb601bd5fc9a6a755feb  agentx-desktop_0.195.1_amd64.deb" | sha256sum --check

    Only continue when it prints agentx-desktop_0.195.1_amd64.deb: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo apt install ./agentx-desktop_0.195.1_amd64.deb

    apt resolves dependencies and sets up the desktop service, which keeps running after you log out. For a pure root install, set AGENTX_DESKTOP_USER=yourlogin before apt.

    Debian / Ubuntu · agentx-desktop · arm64Or download agentx-desktop 0.195.1 directly · 29M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-desktop_0.195.1_arm64.deb
    2 · Check the download
    echo "3a01fece3dc9ebf62307e9eda96edb8319419b6a3c5b2c9eeb01fc00c1ffbe3a  agentx-desktop_0.195.1_arm64.deb" | sha256sum --check

    Only continue when it prints agentx-desktop_0.195.1_arm64.deb: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo apt install ./agentx-desktop_0.195.1_arm64.deb

    apt resolves dependencies and sets up the desktop service, which keeps running after you log out. For a pure root install, set AGENTX_DESKTOP_USER=yourlogin before apt.

    Debian / Ubuntu · agentx-server · amd64Or download agentx-server 0.195.1 directly · 32M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-server_0.195.1_amd64.deb
    2 · Check the download
    echo "9510fb950d3171d855c5faf22235a01008e248fc38ae8cf6bebcae3f8cbd8c5c  agentx-server_0.195.1_amd64.deb" | sha256sum --check

    Only continue when it prints agentx-server_0.195.1_amd64.deb: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo apt install ./agentx-server_0.195.1_amd64.deb

    apt resolves the package's dependencies and installs AgentX.

    Debian / Ubuntu · agentx-server · arm64Or download agentx-server 0.195.1 directly · 29M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-server_0.195.1_arm64.deb
    2 · Check the download
    echo "486645ef37044f0a9357a9c044bb0e5f62e8e79d897e4d32c1cf6233b307589f  agentx-server_0.195.1_arm64.deb" | sha256sum --check

    Only continue when it prints agentx-server_0.195.1_arm64.deb: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo apt install ./agentx-server_0.195.1_arm64.deb

    apt resolves the package's dependencies and installs AgentX.

    Arch Linux · agentx-desktop · x86_64Or download agentx-desktop 0.195.1 directly · 39M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-desktop-0.195.1-1-x86_64.pkg.tar.zst
    2 · Check the download
    echo "efb75cd2ed36e1bc683fcd37067a81ab132596a739d0f16b81bce2614f68f64e  agentx-desktop-0.195.1-1-x86_64.pkg.tar.zst" | sha256sum --check

    Only continue when it prints agentx-desktop-0.195.1-1-x86_64.pkg.tar.zst: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo AGENTX_DESKTOP_USER="$USER" pacman -U ./agentx-desktop-0.195.1-1-x86_64.pkg.tar.zst

    Sets the desktop user explicitly (pacman as root often has an empty SUDO_USER), then installs and enables the user service.

    Arch Linux · agentx-desktop · aarch64Or download agentx-desktop 0.195.1 directly · 36M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-desktop-0.195.1-1-aarch64.pkg.tar.zst
    2 · Check the download
    echo "c08d889f0bea52a9447f31d7f7f35b6a97a473be539154df604b845c58556843  agentx-desktop-0.195.1-1-aarch64.pkg.tar.zst" | sha256sum --check

    Only continue when it prints agentx-desktop-0.195.1-1-aarch64.pkg.tar.zst: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo AGENTX_DESKTOP_USER="$USER" pacman -U ./agentx-desktop-0.195.1-1-aarch64.pkg.tar.zst

    Sets the desktop user explicitly (pacman as root often has an empty SUDO_USER), then installs and enables the user service.

    Arch Linux · agentx-server · x86_64Or download agentx-server 0.195.1 directly · 39M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-server-0.195.1-1-x86_64.pkg.tar.zst
    2 · Check the download
    echo "25ffd24d35b9ef3a41e82d14bf6f12c412b47d999353141a8a94a4756fef827f  agentx-server-0.195.1-1-x86_64.pkg.tar.zst" | sha256sum --check

    Only continue when it prints agentx-server-0.195.1-1-x86_64.pkg.tar.zst: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo pacman -U ./agentx-server-0.195.1-1-x86_64.pkg.tar.zst

    Installs the package and enables the matching systemd service.

    Arch Linux · agentx-server · aarch64Or download agentx-server 0.195.1 directly · 36M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-server-0.195.1-1-aarch64.pkg.tar.zst
    2 · Check the download
    echo "4712f6509d9cff8fec14ebf5823108a6ede24d8e175dbdd03854c11705430815  agentx-server-0.195.1-1-aarch64.pkg.tar.zst" | sha256sum --check

    Only continue when it prints agentx-server-0.195.1-1-aarch64.pkg.tar.zst: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo pacman -U ./agentx-server-0.195.1-1-aarch64.pkg.tar.zst

    Installs the package and enables the matching systemd service.

    RHEL / Rocky / Alma · agentx-desktop · x86_64Or download agentx-desktop 0.195.1 directly · 17M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-desktop-0.195.1-1.x86_64.rpm
    2 · Check the download
    echo "400cdcdac4fb40000bab29546d356770a6f1ca31e57ea6d70ce8474b89899c0e  agentx-desktop-0.195.1-1.x86_64.rpm" | sha256sum --check

    Only continue when it prints agentx-desktop-0.195.1-1.x86_64.rpm: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo dnf install ./agentx-desktop-0.195.1-1.x86_64.rpm
    RHEL / Rocky / Alma · agentx-desktop · aarch64Or download agentx-desktop 0.195.1 directly · 15M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-desktop-0.195.1-1.aarch64.rpm
    2 · Check the download
    echo "439efd7fa99ab7fb83350fcd37280dee94f1807d6c0291dd7f2467fec0a8702c  agentx-desktop-0.195.1-1.aarch64.rpm" | sha256sum --check

    Only continue when it prints agentx-desktop-0.195.1-1.aarch64.rpm: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo dnf install ./agentx-desktop-0.195.1-1.aarch64.rpm
    RHEL / Rocky / Alma · agentx-server · x86_64Or download agentx-server 0.195.1 directly · 17M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-server-0.195.1-1.x86_64.rpm
    2 · Check the download
    echo "04cfb878ed968b2a5de92cbd13e70c2cf1f6edb81ff68d573a143568976da79a  agentx-server-0.195.1-1.x86_64.rpm" | sha256sum --check

    Only continue when it prints agentx-server-0.195.1-1.x86_64.rpm: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo dnf install ./agentx-server-0.195.1-1.x86_64.rpm
    RHEL / Rocky / Alma · agentx-server · aarch64Or download agentx-server 0.195.1 directly · 15M
    1 · Download
    wget https://app.agentxhq.io/releases/agentx-server-0.195.1-1.aarch64.rpm
    2 · Check the download
    echo "b546dc80845540064d0c0f125dc2ed878b264538560e6e78390f1b9c00f404da  agentx-server-0.195.1-1.aarch64.rpm" | sha256sum --check

    Only continue when it prints agentx-server-0.195.1-1.aarch64.rpm: OK. Anything else means the file is damaged or isn't ours, so don't install it.

    3 · Install
    sudo dnf install ./agentx-server-0.195.1-1.aarch64.rpm
    Linux · Docker Engine

    Install Docker Engine. Your user needs permission to pull images and publish a local port.

    1 · Pull the image
    docker pull agentxhq/agentx-daemon:latest

    This command is for linux/amd64. On Linux arm64, docker pull --platform linux/arm64 agentxhq/agentx-daemon:latest fails because there is no linux/arm64 image. Use the native package: native Linux packages.

    2 · Run it
    docker run -d --name agentx --restart unless-stopped \
      -p 127.0.0.1:3333:3333 \
      -v agentx-data:/var/lib/agentx \
      -v agentx-root:/root \
      -v agentx-home:/home \
      agentxhq/agentx-daemon:latest

    This pins nothing yet. To use a fixed version, replace :latest with a tag from Docker Hub.

    Using a port other than 3333? Add -e AGENTX_SURFACES_WEB_PUBLIC_URL_OVERRIDE=http://127.0.0.1:<port> so the claim link sends you back to the right address.

    3 · Open the console
    xdg-open http://127.0.0.1:3333/console

    Or browse to http://127.0.0.1:3333/console. To watch the logs: docker logs -f agentx

    Running AgentX in Docker day to day
    Where your work is storedThree named volumes keep the files when the container is replaced. Unix accounts inside the container do not

    The image runs as root inside the container, the same multi-user mode as agentx-server. Root in the container is not root on your computer unless you give Docker itself more rights.

    AgentX state/var/lib/agentx · volume agentx-data
    Database, identity and enrollment. Also where the agent CLIs are downloaded on first start.
    Default workspaces/root · volume agentx-root
    Agents that run as root work under /root/.agentx/<Name>. CLI logins for root live here too.
    Other users/home · volume agentx-home
    Home folders for any users you create for agents to run as.
    Run agents as separate usersGive an agent its own login user on the machine

    When you create an agent, the picker lists accounts in the container that have a real login shell and a home folder. Create one like this, then set Run as to that user. Its workspace defaults to /home/alice/.agentx/<AgentName>.

    Add a login user
    docker exec -it agentx useradd -m -s /bin/bash alice
    docker exec -it agentx id alice
    List the users AgentX will offer
    docker exec agentx getent passwd | cut -d: -f1,6,7

    Accounts with shells like nologin or false are left out of the picker. Each user keeps their own CLI logins in their home folder.

    Upgrade to a new versionPull, remove, run again with the same volumes
    Upgrade
    docker pull --platform linux/amd64 agentxhq/agentx-daemon:latest && docker rm -f agentx && docker run -d --platform linux/amd64 --name agentx --restart unless-stopped -p 127.0.0.1:3333:3333 -v agentx-data:/var/lib/agentx -v agentx-root:/root -v agentx-home:/home agentxhq/agentx-daemon:latest

    Reusing the same volume names brings your enrollment and workspaces back. To pin a build, replace :latest with a version tag from Docker Hub.

    Accounts after a new container
    docker exec agentx useradd --create-home --home-dir /home/<account> --shell /bin/bash <account>
    docker exec agentx chown -R <account>: /home/<account>

    A new container does not keep Unix accounts of agents that have their own user. Run this again for each such account. The home is already on the agentx-home volume.

    Stop or start overYour volumes stay until you delete them
    Stop
    docker rm -f agentx

    Volumes remain until you delete them yourself.

    Factory reset (deletes everything)
    docker rm -f agentx
    docker volume rm agentx-data agentx-root agentx-home

    This removes enrollment, workspaces and CLI logins. You will need to connect the computer again.

  3. 3

    Connect it to your account

    Linux packages and Docker start AgentX automatically. On Windows, AgentX starts when the installer finishes. On Mac with Homebrew, run agentx-daemon background if it isn't running yet. Then claim it so it joins your account:

    1. Open the local AgentX console at 127.0.0.1:3333. While it waits, it shows a claim code and a claim link.
    2. Open the claim link, or paste the claim code into the claim flow in your AgentX console.
    3. Sign in and confirm “Connect this computer”. The machine joins your account.
    Running in Docker?

    Leave port 3334 unpublished. AgentX uses it inside the container only; nothing outside needs it.

    Enrolling many machines? Use a deployment token

    A deployment token is a reusable enrollment key you create in Settings. With one, you can enroll with the token install command instead of the interactive claim link. Same end state, no clicking per machine.

  4. 4

    Open your console

    Once the computer is connected, your agents, sessions and artifacts are live in the console. Create named agents, put them in a chat, and set them to work. https://www.agentxhq.com/console