CLI reference

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

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` or `copilot`	`claude`
`DIFFBLUE_AGENTS_CLAUDE_CLI_PATH`	Path to Claude CLI executable	`claude`
`DIFFBLUE_AGENTS_CLAUDE_CLI_MAX_TURNS`	Max agent turns per CLI invocation	`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_GIT_SIGNING`	Enable git commit/tag signing	`true`

List available workflows:

diffblue-agents workflows

Run a workflow:

diffblue-agents run regression-unit-tests

Run on a custom server port:

DIFFBLUE_AGENTS_SERVER_PORT=8081 diffblue-agents run regression-unit-tests