Skip to main content

​
Prerequisites

​
Step 1 - Create your account

Go to console.ironbee.ai and sign up. Your account gives you access to the dashboard and generates the API key the CLI needs to ship session data.

​
Step 2 - Install the CLI

Verify the installation:

​
Step 3 - Connect the CLI to your account

Run ironbee login from any directory. It opens your browser at console.ironbee.ai, asks you to authorize the CLI, and writes a personal OAuth access token and collector URL to ~/.ironbee/config.json automatically.
The browser opens, you confirm, and the terminal prints:
The token is named after your machine by default and shows up on the API Tokens page in the Console, where you can revoke it anytime.
For automation that has no browser, the GitHub Action or any CI pipeline and use an account API key instead of ironbee login. Supply it through the environment:
Find the account API key on the Account page in the Console. See Authentication for when to use each credential.

​
Step 4 - Set up your project

Navigate to your project directory and run:
IronBee auto-detects your AI client and writes:
  • Hook configuration — the client calls IronBee automatically when the agent finishes
  • Verification skill/rules — the agent knows the verification workflow
  • MCP server entries — browser-devtools, node-devtools, and backend-devtools
  • Permissions — grants the agent access to devtools tools
If you are using Cursor, you need one extra step after install: go to Settings → Tools & MCP and confirm all three MCP servers (browser-devtools, node-devtools, backend-devtools) are enabled. See Cursor setup for details.

​
Step 5 - Let the agent work

Open Claude Code, Cursor, or Codex and give the agent a task: When the agent finishes editing code, IronBee intercepts the completion and requires verification:
  1. The agent navigates to the affected pages in a real browser
  2. It takes screenshots, checks the console, and tests functionality
  3. It submits a verdict, pass or fail
  4. If it fails, the agent fixes the issues and re-verifies

​
Step 6 - View your results

Open the IronBee Console and navigate to your project. You will find:
  • The session with all activity recorded
  • Screenshots and browser interactions from each verification cycle
  • Pass/fail verdict with evidence
  • Timing breakdowns how long the agent spent coding, verifying, and fixing

​
What’s next?

CLI configuration

Customize verify patterns, retry limits, and devtools settings.

Enable backend verification

Add Node.js or backend protocol verification for backend code changes.

GitHub Action

Verify changes automatically on every pull request.

Explore the console

Understand sessions, verifications, findings, and recommendations.