Skip to main content
Verification needs your application running, that’s true for every verification platform, not just the browser. This guide covers how to point the action at your app’s lifecycle commands, work in a monorepo, and focus the agent on what matters.

​
App lifecycle commands

Four inputs describe how to bring your app up. The first three (install, build, start) run in order before verification; app_url tells the browser where to reach it:
InputPurposeExample
app_install_commandInstall dependenciesnpm ci
app_build_commandBuild the appnpm run build
app_start_commandStart the servernpm run start
app_urlWhere to reach it (browser mode)http://localhost:3000
- uses: ironbee-ai/ironbee-action@v1
  with:
    ironbee_api_key: ${{ secrets.IRONBEE_API_KEY }}
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    app_install_command: 'npm ci'
    app_build_command: 'npm run build'
    app_start_command: 'npm run start'
    app_url: 'http://localhost:3000'
All four are optional, but providing them is recommended. If you leave them out, the agent still verifies, it just has to resolve how to install, build, start, and reach your app from the repository first. Spelling the commands out skips that guesswork, so runs are faster and more reliable. Omit only the steps that don’t apply (e.g. app_build_command when there’s no build).

​
Monorepos

Point the action at a subdirectory with working_directory. All commands, config, and verification run relative to it: 
- uses: ironbee-ai/ironbee-action@v1
  with:
    ironbee_api_key: ${{ secrets.IRONBEE_API_KEY }}
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    working_directory: 'packages/web-app'
    app_install_command: 'npm ci'
    app_start_command: 'npm run dev'
    app_url: 'http://localhost:3000'

​
Focusing the agent

By default the agent decides what to verify from the diff. Steer it when you want specific coverage:
InputEffect
promptExtra instructions appended to the verification prompt
max_turnsCap on Claude Code conversation turns (default 100)
modelOverride the Claude model
- uses: ironbee-ai/ironbee-action@v1
  with:
    ironbee_api_key: ${{ secrets.IRONBEE_API_KEY }}
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: 'Focus on the checkout flow and payment form validation'
    max_turns: '30'
Give the job enough headroom — verification, fixes, and re-verification can take a while. Set a generous timeout-minutes on the job (the examples use 45).

​
What’s next?

Verification platforms

Verify through the browser, backend, and Node.js.

All configuration options

Every input and output, with defaults.