> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diffblue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI reference

> Commands, environment variables, and usage examples for the Diffblue Agents CLI

## Commands

```
diffblue-agents [command] [options]
```

| Command | Description |
| - | - |
| `help` | Show help message |
| `version` | Show the version of this application |
| `workflows` | Show available workflows and their requirements |
| `run <NAME or ID> [ARGS...]` | Run a workflow with optional arguments |
| `install` | Configure an AI coding agent interactively |
| `license` | Show license status, licensed agents, and quota |
| `license activate <KEY>` | Activate a license key |
| `license deactivate` | Deactivate the current license |

## Environment variables

| Variable | Description | Default |
| - | - | - |
| `DIFFBLUE_AGENTS_SERVER_SCHEME` | Server communication protocol | |
| `DIFFBLUE_AGENTS_SERVER_NAME` | Server host | `localhost` |
| `DIFFBLUE_AGENTS_SERVER_PORT` | Server port override (normally auto-assigned; see `.diffblue/server.json`) | |
| `DIFFBLUE_AGENTS_SERVER_REQUEST_TIMEOUT` | Request timeout in ms | `5000` |
| `DIFFBLUE_AGENTS_JAVA_HOME` | Java installation for building and testing target projects | |
| `DIFFBLUE_AGENTS_PLATFORM` | Agent platform: `claude`, `copilot`, `gemini`, or `opencode` | `claude` |
| `DIFFBLUE_AGENTS_CLAUDE_CLI_PATH` | Path to Claude CLI executable | `claude` |
| `DIFFBLUE_AGENTS_CLI_MAX_TURNS` | Max agent turns per CLI invocation (Claude and Copilot only; ignored by Gemini and OpenCode) | `25` |
| `DIFFBLUE_AGENTS_AGENT_TIMEOUT` | CLI agent process timeout, ISO-8601 | `PT20M` |
| `DIFFBLUE_AGENTS_PLANNING_DETECTION_TIMEOUT` | Planning detection step timeout, ISO-8601 | `PT20M` |
| `DIFFBLUE_AGENTS_TEST_GENERATION_TIMEOUT` | Per work-unit test generation timeout, ISO-8601 | `PT10M` |
| `DIFFBLUE_AGENTS_PROCESS_TIMEOUT` | Default subprocess timeout (utility commands), ISO-8601 | `PT2M` |
| `DIFFBLUE_AGENTS_COVERAGE_TEST_TIMEOUT` | Test execution timeout during coverage measurement, ISO-8601 | `PT5M` |
| `DIFFBLUE_AGENTS_COPILOT_CLI_PATH` | Path to Copilot CLI executable | `copilot` |
| `DIFFBLUE_AGENTS_GEMINI_CLI_PATH` | Path to Gemini CLI executable | `gemini` |
| `DIFFBLUE_AGENTS_OPENCODE_CLI_PATH` | Path to OpenCode CLI executable | `opencode` |
| `DIFFBLUE_AGENTS_OPENCODE_MODEL` | OpenCode model override in `provider/model` form (for example, `anthropic/claude-sonnet-4-6`). When unset, Diffblue Agents picks the first available model from a built-in fallback list. | |
| `DIFFBLUE_AGENTS_GIT_SIGNING` | Enable git commit/tag signing | `true` |

## Examples

List available workflows:

```bash theme={null}
diffblue-agents workflows
```

Run a workflow:

```bash theme={null}
diffblue-agents run regression-unit-tests
```

Run on a custom server port:

```bash theme={null}
DIFFBLUE_AGENTS_SERVER_PORT=8081 diffblue-agents run regression-unit-tests
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.