macOS installation
AgentDock provides prebuilt releases for Apple Silicon and Intel Macs. A regular installation does not require Go, Git, or the source repository.
Use the native installation for local files and for macOS desktop automation that needs Screen Recording and Accessibility permissions.
1. Install AgentDock
curl -fL https://github.com/uvwt/agentdock/releases/latest/download/install-macos.sh \
-o /tmp/install-agentdock-macos.sh
zsh /tmp/install-agentdock-macos.sh
The script detects the Mac architecture, verifies the download, and installs AgentDock at:
~/.local/bin/agentdock
If the script reports that this directory is not in PATH, run:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zprofile
export PATH="$HOME/.local/bin:$PATH"
2. Start AgentDock
agentdock --host 127.0.0.1 --port 8765
Keep this terminal open. You do not need a background service for the first trial.
3. Verify startup
Open another terminal and run:
curl -fsS http://127.0.0.1:8765/healthz
A healthy response contains ok: true.
4. Connect an MCP client
For a client on the same Mac, use:
Transport Streamable HTTP
URL http://127.0.0.1:8765/mcp
Authentication Not required
Authentication may be disabled while listening only on 127.0.0.1. LAN or public access requires authentication and HTTPS.
Installation is complete when the health check succeeds and the client connects. You can then use files, commands, Git, and Skills.
Update
Download and run the latest installer again. Tasks, Skills, configuration, and the working directory are preserved, and the previous binary is backed up first.
Continue when needed
- For a fixed version, custom installation directory, or background service, see Advanced macOS configuration.
- For screen, keyboard, and mouse automation, see macOS desktop automation.
- For browser automation, the current build-free option is the Docker browser image. See Browser automation.
- If startup fails, see Troubleshooting.