Installation

Two ways to install AgentDock: a packaged release, or building from source.

There are two ways to get AgentDock running: download a packaged release, or build it from source.

Option A: download a packaged release (recommended)

Prebuilt binaries are published on the GitHub Releases page and linked from agdc.dev/downloads. No Node.js, git clone, or build step required. Pick your platform:

Windows — NSIS installer or portable executable.
macOS — DMG or zip, Intel and Apple Silicon.
Linux — AppImage (experimental).

Unsigned builds

Current releases are unsigned. Windows SmartScreen and macOS Gatekeeper will both warn on first launch — this is expected. Each platform page explains how to get past it.

Option B: build from source

Useful on Linux, for the latest unreleased changes, or if you're developing on AgentDock itself.

bash

git clone https://github.com/crossainthero-lab/AgentDock.git
cd AgentDock
npm install
npm run dev

npm install runs a postinstall step that fixes execute permissions on node-pty's native binaries, which the terminal/PTY integration needs. See System requirements for the Node.js version needed to build from source.

Next steps

Once AgentDock is installed, continue to First launch and Connecting your coding agents.