Skip to main content

​
Prerequisites

Verify that you meet the system requirements before proceeding.

​
Download

Download the Diffblue Agents archive for your platform: 
curl -LO https://release.diffblue.com/diffblue-agents/latest-macos_aarch64

​
Install

  1. Extract the archive: 
    unzip diffblue-agents-*.zip
  2. Add the cli directory to your PATH or create an alias: 
    # current session
export PATH="$HOME/diffblue-agents/cli:$PATH"
# or persistent (all future sessions)
echo 'export PATH="$HOME/diffblue-agents/cli:$PATH"' >> ~/.zshrc
source ~/.zshrc
# or alias
alias diffblue-agents="$HOME/diffblue-agents/cli/diffblue-agents"
  3. Verify the installation: 
    diffblue-agents version
The archive includes a bundled JRE for the Agents server and a bundled CLI runtime. You do not need to install Java or Node.js separately for Agents — only for building and testing your target project.
macOS may quarantine files downloaded from the internet. If you see a warning that the file is from an unidentified developer, remove the quarantine attribute:
xattr -r -d com.apple.quarantine diffblue-agents/
Windows may block downloaded scripts from executing. Before running Diffblue Agents, unblock the required files in PowerShell:
Unblock-File cli\diffblue-agents.ps1
Unblock-File server\diffblue-agents-server.ps1
Unblock-File jre\bin\java.exe
Then restart your terminal.

​
Configure your AI coding agent

Diffblue Agents uses Claude Code by default. To select a different supported AI coding agent platform or provide a custom path, run: 
diffblue-agents install
This scans your PATH for supported agents and presents an interactive selection. If your agent is not detected automatically, choose “Enter path manually” to specify the agent type and executable path. See the CLI reference for all configuration options.

​
Next steps

  • Quickstart — activate your license and run your first workflow.