IRONBEE_EXTRA_CONFIG passes raw JSON that is deep-merged into the .ironbee/config.json the pipe generates. Your keys win over the defaults.
IRONBEE_EXTRA_CONFIG applies to local mode only, when the verification runs inside the pipe. On IronBee, the pipe logs a warning and ignores it.How it works
Pass a JSON object as a string. It’s merged on top of the configuration the pipe generates, so you only list the keys you want to change:.ironbee/config.json, so a configuration file committed to your repository isn’t used. With IRONBEE_EXCLUDE_FILES on, the default, the pipe restores your file when the run ends.
Tuning the DevTools server
The local-mode platforms are served by oneironbee-devtools MCP server. Pass extra environment variables to it under ironbeeDevTools.env:
IronBee always sets its own invariants (the tool-name prefix, metadata flags and platform) last. They can’t be overridden through
IRONBEE_EXTRA_CONFIG.Committing the generated setup
The changes IronBee’s setup makes to.claude/, .mcp.json and .gitignore stay out of the commits the pipe makes, because they’re its working files rather than the change being verified. To commit the setup it generated together with a fix, for example to use it for local development, set IRONBEE_EXCLUDE_FILES: "false". A run that commits no fix commits no setup either. .ironbee/ stays out either way.
What’s next?
Local-mode platforms
The platforms the DevTools server provides.
Configuration
Every variable and output, with defaults.