Skip to main content

​
Prerequisites

Verify that you meet the system requirements before proceeding.

​
Install

curl -fsSL https://release.diffblue.com/diffblue-agents/install.sh | sh
The install script downloads the latest release for your platform, extracts it to ~/.diffblue/agents/ (%USERPROFILE%\.diffblue\agents on Windows), and adds it to your PATH. To reinstall or update, run the same command again: the script will replace the existing installation. If the Diffblue Agents server is running, stop it before reinstalling with diffblue-agents --stop-server from your project directory. To verify, navigate to your project directory and run: 
diffblue-agents version
To pass options, download and run the script directly instead of piping it:
curl -fsSL https://release.diffblue.com/diffblue-agents/install.sh -o install.sh
sh install.sh --force --install-dir /opt/diffblue-agents
OptionShellPowerShellDescription
Custom install directory--install-dir <path>-InstallDir <path>Install to a custom directory instead of ~/.diffblue/agents/
Skip PATH modification--no-modify-path-NoModifyPathDo not add the cli directory to your PATH
Force--force-ForceStop a running server before overwriting the existing installation
You can also install manually by downloading and extracting the archive yourself.

​
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, use the install command.

​
Interactive configuration

Run the install command without arguments to select your agent interactively: 
diffblue-agents install
The install command scans your PATH for supported agents and presents an interactive selection menu. If your agent is not detected automatically, select “Enter path manually” to specify the agent type and executable path. The install command saves your selection and then validates that the selected agent works correctly by running a test prompt, which may take up to 60 seconds. If validation fails, you may need to rerun the install command to correct the saved path.

​
Non-interactive configuration

To configure an agent without using the interactive selection menu, specify the agent type and path directly: 
diffblue-agents install agent <agent-type> <path-to-agent>
Replace <agent-type> with claude or copilot, and <path-to-agent> with the absolute path to the agent executable. Example: 
diffblue-agents install agent claude /usr/local/bin/claude
This mode is useful for automated setup or CI/CD pipelines.

​
Configuration options

See the CLI reference for all configuration options, including environment variables for agent platform selection and custom paths.

​
Manual install

  1. Download the archive for your platform: 
    curl -JLO https://release.diffblue.com/diffblue-agents/latest-macos_aarch64
  2. Extract the archive: 
    unzip diffblue-agents-*.zip
  3. Add the cli directory to your PATH or create an alias. Replace X.X.X with the version you installed. 
    # add the cli directory to your PATH:
echo 'export PATH="$HOME/diffblue-agents-X.X.X-macos_aarch64/cli:$PATH"' >> ~/.zshrc
source ~/.zshrc

# or, create an alias:
echo 'alias diffblue-agents="$HOME/diffblue-agents-X.X.X-macos_aarch64/cli/diffblue-agents"' >> ~/.zshrc
source ~/.zshrc
  4. Verify the installation: 
    diffblue-agents version

​
Troubleshooting

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 from the extracted directory:
# Apple Silicon
xattr -r -d com.apple.quarantine diffblue-agents-X.X.X-macos_aarch64/

# Intel
xattr -r -d com.apple.quarantine diffblue-agents-X.X.X-macos_amd64/
Windows may block downloaded scripts from executing. In PowerShell, navigate into the Diffblue Agents installation directory and run:
Unblock-File cli\diffblue-agents.ps1
Unblock-File server\diffblue-agents-server.ps1
Unblock-File jre\bin\java.exe
If the scripts still fail to execute after unblocking, set your PowerShell execution policy to RemoteSigned for the current user:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Then restart your terminal.

​
Next steps

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