Configuration

The complete input and output reference. For task-oriented walkthroughs, see the guides: Running in CI, Verifying your application, Verification platforms, Evidence, Diagnostics, and Custom configuration. The only required input is ironbee_api_key, plus one form of Claude authentication (anthropic_api_key or claude_code_oauth_token).

Inputs

IronBee - Auth & Reporting

Input	Required	Default	Description
`ironbee_api_key`	Yes		Your account API key (from the Console Account page) used to authenticate the collector. Passed as an env var, never written to disk.
`ironbee_collector_url`	No	`https://collector.service.ironbee.ai`	IronBee collector endpoint URL.
`ironbee_console_url`	No	`console.ironbee.ai`	IronBee Console hostname (no scheme) used to build session links in the PR report.

IronBee - DevTools Modes

Input	Required	Default	Description
`ironbee_browser_devtools`	No	`true`	Enable browser DevTools verification (browser MCP).
`ironbee_backend_devtools`	No	`false`	Enable backend DevTools verification (backend MCP).
`ironbee_node_devtools`	No	`false`	Enable Node.js DevTools verification (node MCP).

IronBee - Install & Config

Input	Required	Default	Description
`ironbee_cli_version`	No	`latest`	IronBee CLI version to install (e.g. `0.4.1`).
`ironbee_exclude_files`	No	`false`	Set `true` to keep IronBee config files (`.ironbee/`, `.claude/`, `.mcp.json`) out of commits.
`ironbee_extra_config`	No		Raw IronBee config as a JSON string, deep-merged into the generated `.ironbee/config.json` (your keys win).

Claude Code

Input	Required	Default	Description
`anthropic_api_key`	Yes*		Anthropic API key for Claude Code.
`claude_code_oauth_token`	No*		Claude Code OAuth token (alternative to the API key).
`claude_code_cli_version`	No	`latest`	Claude Code CLI version to install.
`model`	No		Claude model override (e.g. `claude-sonnet-4-5-20250514`).
`max_turns`	No	`100`	Maximum conversation turns for Claude Code.
`prompt`	No		Additional instructions for the verification agent.
`claude_args`	No		Additional Claude Code CLI arguments.

Application Under Test

Input	Required	Description
`app_install_command`	No	Command to install dependencies (e.g. `npm ci`).
`app_build_command`	No	Command to build the application (e.g. `npm run build`).
`app_start_command`	No	Command to start the application (e.g. `npm run dev`).
`app_url`	No	Application URL for browser verification (e.g. `http://localhost:3000`).

GitHub & General

Input	Required	Default	Description
`github_token`	No	`${{ github.token }}`	GitHub token for PR operations.
`working_directory`	No	`.`	Working directory for verification.
`verbose`	No	`false`	Enable verbose CI logging (tool responses, prompt, artifact list, verdict details).

*One of anthropic_api_key or claude_code_oauth_token is required. ironbee_api_key is always required.

Outputs

Output	Description
`verdict`	Final verification result: `pass`, `fail`, or `unknown`.
`artifacts_url`	Download URL for verification evidence (screenshots, recordings).

Caching

Playwright Chromium binaries (~200 MB) are cached using actions/cache to speed up subsequent runs. The cache key is based on the runner OS. Browser downloads during npm install are skipped (PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=true) and installed separately with system dependencies.

Introduction

Concepts

CLI

GitHub Action

Help

Inputs

IronBee - Auth & Reporting

IronBee - DevTools Modes

IronBee - Install & Config

Claude Code

Application Under Test

GitHub & General

Outputs

Caching

​Inputs

​IronBee - Auth & Reporting

​IronBee - DevTools Modes

​IronBee - Install & Config

​Claude Code

​Application Under Test

​GitHub & General

​Outputs

​Caching

Inputs

IronBee - Auth & Reporting

IronBee - DevTools Modes

IronBee - Install & Config

Claude Code

Application Under Test

GitHub & General

Outputs

Caching