Skip to main content

Commands

diffblue-agents [command] [options]
CommandDescription
helpShow help message
versionShow the version of this application
workflowsShow the workflows available to perform
run <NAME or ID> [ARGS...]Run a workflow with optional arguments
installConfigure an AI coding agent interactively
licenseShow license status
license activate <KEY>Activate a license key
license deactivateDeactivate the current license

Environment variables

VariableDescriptionDefault
DIFFBLUE_AGENTS_SERVER_SCHEMEServer communication protocol
DIFFBLUE_AGENTS_SERVER_NAMEServer hostlocalhost
DIFFBLUE_AGENTS_SERVER_PORTServer port override (normally auto-assigned; see .diffblue/server.json)
DIFFBLUE_AGENTS_SERVER_REQUEST_TIMEOUTRequest timeout in ms5000
DIFFBLUE_AGENTS_JAVA_HOMEJava installation for building and testing target projects
DIFFBLUE_AGENTS_PLATFORMAgent platform: claude or copilotclaude
DIFFBLUE_AGENTS_CLAUDE_CLI_PATHPath to Claude CLI executableclaude
DIFFBLUE_AGENTS_CLAUDE_CLI_MAX_TURNSMax agent turns per CLI invocation25
DIFFBLUE_AGENTS_AGENT_TIMEOUTCLI agent process timeout, ISO-8601PT20M
DIFFBLUE_AGENTS_PLANNING_DETECTION_TIMEOUTPlanning detection step timeout, ISO-8601PT20M
DIFFBLUE_AGENTS_TEST_GENERATION_TIMEOUTPer work-unit test generation timeout, ISO-8601PT10M
DIFFBLUE_AGENTS_COPILOT_CLI_PATHPath to Copilot CLI executablecopilot
DIFFBLUE_AGENTS_GIT_SIGNINGEnable git commit/tag signingtrue

Examples

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