Install Diffblue Agents

Prerequisites

Verify that you meet the system requirements before proceeding.

Install

macOS (Apple Silicon)
macOS (Intel)
Linux
Windows

curl -fsSL https://release.diffblue.com/diffblue-agents/install.sh | sh

curl -fsSL https://release.diffblue.com/diffblue-agents/install.sh | sh

curl -fsSL https://release.diffblue.com/diffblue-agents/install.sh | sh

irm https://release.diffblue.com/diffblue-agents/install.ps1 | iex

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

Installation customization

To pass options, download and run the script directly instead of piping it:

macOS (Apple Silicon)
macOS (Intel)
Linux
Windows

curl -fsSL https://release.diffblue.com/diffblue-agents/install.sh -o install.sh
sh install.sh --force --install-dir /opt/diffblue-agents

curl -fsSL https://release.diffblue.com/diffblue-agents/install.sh -o install.sh
sh install.sh --force --install-dir /opt/diffblue-agents

curl -fsSL https://release.diffblue.com/diffblue-agents/install.sh -o install.sh
sh install.sh --force --install-dir /opt/diffblue-agents

& ([scriptblock]::Create((irm https://release.diffblue.com/diffblue-agents/install.ps1))) -Force -InstallDir C:\diffblue-agents

Option	Shell	PowerShell	Description
Custom install directory	`--install-dir <path>`	`-InstallDir <path>`	Install to a custom directory instead of `~/.diffblue/agents/`
Skip PATH modification	`--no-modify-path`	`-NoModifyPath`	Do not add the `cli` directory to your `PATH`
Force	`--force`	`-Force`	Stop 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

Download the archive for your platform:

macOS (Apple Silicon)
macOS (Intel)
Linux
Windows

curl -JLO https://release.diffblue.com/diffblue-agents/latest-macos_aarch64

curl -JLO https://release.diffblue.com/diffblue-agents/latest-macos_amd64

curl -JLO https://release.diffblue.com/diffblue-agents/latest-linux

curl.exe -JLO https://release.diffblue.com/diffblue-agents/latest-windows

Extract the archive:

macOS (Apple Silicon)
macOS (Intel)
Linux
Windows

unzip diffblue-agents-*.zip

unzip diffblue-agents-*.zip

unzip diffblue-agents-*.zip

Expand-Archive diffblue-agents-*.zip .

Add the cli directory to your PATH or create an alias. Replace X.X.X with the version you installed.

macOS (Apple Silicon)
macOS (Intel)
Linux
Windows

# 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

# add the cli directory to your PATH:
echo 'export PATH="$HOME/diffblue-agents-X.X.X-macos_amd64/cli:$PATH"' >> ~/.zshrc
source ~/.zshrc

# or, create an alias:
echo 'alias diffblue-agents="$HOME/diffblue-agents-X.X.X-macos_amd64/cli/diffblue-agents"' >> ~/.zshrc
source ~/.zshrc

# add the cli directory to your PATH:
echo 'export PATH="$HOME/diffblue-agents-X.X.X-linux_amd64/cli:$PATH"' >> ~/.bashrc
source ~/.bashrc

# or, create an alias:
echo 'alias diffblue-agents="$HOME/diffblue-agents-X.X.X-linux_amd64/cli/diffblue-agents"' >> ~/.bashrc
source ~/.bashrc

# add the cli directory to your PATH:
[Environment]::SetEnvironmentVariable("PATH", "$HOME\diffblue-agents-X.X.X-windows_amd64\cli;$([Environment]::GetEnvironmentVariable("PATH", "User"))", "User")

# or, create an alias:
Set-Alias diffblue-agents "$HOME\diffblue-agents-X.X.X-windows_amd64\cli\diffblue-agents.ps1"

Verify the installation:
diffblue-agents version

Troubleshooting

macOS: remove quarantine attribute

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: scripts blocked from executing

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.

Getting started

Diffblue Testing Agent

Diffblue Test Quality Agent

Reference

Legal

Prerequisites

Install

Configure your AI coding agent

Interactive configuration

Non-interactive configuration

Configuration options

Manual install

Troubleshooting

Next steps

​Prerequisites

​Install

​Configure your AI coding agent

​Interactive configuration

​Non-interactive configuration

​Configuration options

​Manual install

​Troubleshooting

​Next steps

Prerequisites

Install

Configure your AI coding agent

Interactive configuration

Non-interactive configuration

Configuration options

Manual install

Troubleshooting

Next steps