Skip to main content
The IronBee CLI connects your AI coding agent to IronBee. Once installed in a project, it wires up the hooks and tools your agent needs so that every code change gets verified before a task is marked complete. This guide covers the basics: create an account, install the CLI, sign in, and set up your first project. That’s all you need to get going; deeper configuration comes later.

​
Prerequisites

​
Overview

1

Create your account

Sign up at console.ironbee.ai.
2

Install the CLI

npm install -g @ironbee-ai/cli installs the ironbee command globally.
3

Sign in

ironbee login connects the CLI to your account. One time per machine.
4

Set up your project

cd into your project and run ironbee install to wire up your AI client.

​
Step 1: Create your account

Go to console.ironbee.ai and sign up. If you already have an account, just sign in. Your account gives you access to the dashboard and is what the CLI connects to in the next steps.

​
Step 2: Install the CLI

Install the CLI globally with npm:
Verify the installation:

​
Step 3: Sign in

From any directory, run:
This opens Connect CLI on console.ironbee.ai in your browser. Sign in if you’re asked to; the console then authorizes the CLI on its own, and the CLI stores a personal OAuth access token locally. You only need to do this once per machine. When it completes, the terminal prints a confirmation:
If the browser doesn’t open automatically, the CLI prints a URL you can paste in manually. Running in CI with no browser? Use an account API key instead, see Authentication.

​
Step 4: Set up your project

Navigate to the project you want to use IronBee with, then run the installer:
IronBee detects your AI client (Claude Code, Cursor, or Codex) and sets it up automatically. If it can’t detect one - or detects more than one - it asks which client(s) to install for: a checkbox multi-select where space toggles a client, a selects all, and Enter confirms (so you can set up several at once). When several were detected they come pre-checked; deselect any you don’t want. Checkbox multi-select titled 'Which client(s) to install for?' with claude checked and cursor and codex unchecked Then it walks you through a few quick arrow-key pickers. First, which verification mode to run:
  • assist (default): the verifier and /ironbee-verify are installed so the agent can verify on demand, but nothing blocks task completion.
  • enforce: changes must pass every active cycle before a task can complete. Enforce also asks how strict the gate is and whether a failed verification must be fixed.
  • monitor: tracking only. Sessions, activity, and tool calls are recorded to the Collector; no verification machinery is installed.
Arrow-key picker titled 'Which verification mode?' with auto verify (enforce), assist, and monitor only options, the cursor on assist Then, unless you chose monitor, which platforms to verify:
  • Browser: on by default; covers most frontend work.
  • Node, Python, Backend, Android, and Terminal: opt-in; enable any you want gated.
  • Not sure which to pick? Press s to let IronBee analyze your project with your AI client (Claude Code, Codex or Cursor) and suggest the set.
In enforce mode, the installer can also set up project checks (beta): commands such as lint and tests that run first in every verification. Multi-select titled 'Which platforms should require verification?' with browser checked and node, backend, android, and terminal unchecked Platform multi-select with the 's suggest (claude)' key highlighted and 'Analysing project with claude…' shown while IronBee recommends platforms You can change both anytime later (see Verification). That’s it. Your project is now connected to IronBee.
Restart your AI coding client after installing so it picks up the new setup.

​
What’s next?

Give your agent a task as you normally would. In assist mode, ask for a verification with /ironbee-verify when the change is ready. In enforce mode, IronBee has the agent verify the changes before the task can complete. Every session shows up in the Console.

How verification works

Understand the completion gate, cycles, and verdicts behind what you just set up.

Managing projects

Install, remove, update, and track IronBee across your projects.