Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ironbee.ai/llms.txt

Use this file to discover all available pages before exploring further.

The IronBee GitHub Action brings the same verification loop you get with the CLI into your CI/CD pipeline. On every push or pull request, it orchestrates Claude Code with the IronBee CLI to review your code changes, test them in a real browser, fix any issues found, and post a detailed report on the PR.

​
What it does

1

Review

The action reads the diff for the PR or push and identifies which pages and flows are affected.
2

Build & start

Your application is built and started using the commands you configure (app_build_command, app_start_command).
3

Verify

Claude Code runs /ironbee-verify (or /ironbee-verify full for manual/scheduled runs), navigating pages, taking screenshots, and testing functionality in a real Chromium browser.
4

Fix

If verification fails, the agent automatically fixes the issues and re-verifies. Fixes are committed to the PR branch or opened as a new PR depending on the trigger.
5

Report

A verification report is posted as a PR comment with screenshots, per-cycle breakdowns, and a final pass/fail verdict.

​
Evidence artifacts

All screenshots and recordings are organized by verification cycle: 
.ironbee/artifacts/
  cycle-1/
    screenshots/homepage-before-fix.png
    recordings/verification.webm
  cycle-2/
    screenshots/homepage-after-fix.png
    recordings/verification.webm
Evidence is uploaded as GitHub Actions artifacts (30-day retention) and linked in the PR comment. With S3 configured, screenshots render inline in the comment.

​
Trigger modes

The action adapts its behavior based on what triggered it:
TriggerVerification scopeFix behavior
pull_requestDiff-based — affected pages onlyCommits fixes to the PR branch
push (main/master)Diff-based — affected pages onlyCreates a new fix PR automatically
workflow_dispatchFull — entire applicationCreates a new fix PR automatically
scheduleFull — entire applicationCreates a new fix PR automatically

​
Outputs

OutputValuesDescription
verdictpass, fail, unknownFinal verification result
artifacts_urlURL stringDownload link for screenshots and recordings

​
Next step

Get started

Add the action to your workflow in two minutes.