Documentation Index
Fetch the complete documentation index at: https://docs-proxy.diffblue.io/llms.txt
Use this file to discover all available pages before exploring further.
System requirements
| Requirement | Details |
|---|---|
| Operating system | macOS, Linux, or Windows |
| Git | 2.25+ |
Supported AI coding agent platforms
You need one of the following AI coding agent platforms installed and authenticated:- Claude Code
- GitHub Copilot CLI
diffblue-agents install to select your agent platform or provide a custom path.
The Diffblue Agents archive includes bundled Java and Node.js runtimes. You only need to install Java and Node.js if needed for building and testing your target project.
Project requirements
Your project must be in a Git repository with a clean working tree.Java projects
| Requirement | Details |
|---|---|
| Java | JDK version(s) relevant for your particular project must be installed. |
| Build tool | Maven or Gradle. mvn or gradle must be on PATH or Maven/Gradle wrapper is present in your project’s root. |
Python projects
| Requirement | Details |
|---|---|
| Python | A python3, python, or py interpreter must be installed. Diffblue Agents scans PATH and common installation locations (Homebrew, pyenv, asdf, Conda, system directories) automatically. |
| venv | The venv module must be available. On Debian/Ubuntu (including WSL), install python3-venv separately: sudo apt install python3-venv. On macOS and Windows, venv is included with Python. |
| Test framework | Dependencies such as pytest and pytest-cov are installed automatically by the prepare project workflow if not already installed. |
Network access
The Diffblue Agents server runs locally. Network access is required for:- License activation and validation (
https://api.licensespring.com,https://licensing.diffblue.com) - A working AI coding agent platform
- Dependency resolution (Maven Central, Gradle repositories, PyPI, etc.)