GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Diffblue Agents home page
  • Cover Docs
  • Community Forum
  • Website
  • Requirements
  • Install Diffblue Agents
  • Troubleshooting
  • Support
  • Changelog
  • Quickstart
  • Prepare project for test generation
  • Plan regression unit test generation
  • Regression unit test generation
  • Quickstart

This view

  • Original page
  • New address

GeezerVison is showing docs.diffblue.com — CLI reference - Diffblue Agents

​
Commands

diffblue-agents [command] [options]
CommandDescription
helpShow help message
versionShow the version of this application
workflowsShow available workflows and their requirements
run <NAME or ID> [ARGS...]Run a workflow with optional arguments
installConfigure an AI coding agent interactively
licenseShow license status, licensed agents, and quota
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, copilot, gemini, or opencodeclaude
DIFFBLUE_AGENTS_CLAUDE_CLI_PATHPath to Claude CLI executableclaude
DIFFBLUE_AGENTS_CLI_MAX_TURNSMax agent turns per CLI invocation (Claude and Copilot only; ignored by Gemini and OpenCode)25
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_PROCESS_TIMEOUTDefault subprocess timeout (utility commands), ISO-8601PT2M
DIFFBLUE_AGENTS_COVERAGE_TEST_TIMEOUTTest execution timeout during coverage measurement, ISO-8601PT5M
DIFFBLUE_AGENTS_COPILOT_CLI_PATHPath to Copilot CLI executablecopilot
DIFFBLUE_AGENTS_GEMINI_CLI_PATHPath to Gemini CLI executablegemini
DIFFBLUE_AGENTS_OPENCODE_CLI_PATHPath to OpenCode CLI executableopencode
DIFFBLUE_AGENTS_OPENCODE_MODELOpenCode 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_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
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.