Environment variables¶
Optional environment overrides BXP reads at startup — all of them optional, BXP works with none set.
| Variable | Effect |
|---|---|
BXP_CLI_PATH |
Absolute path to the bxp-cli binary the desktop app should run, instead of the one bundled beside it. |
BXP_EXAMPLES_PATH |
Absolute path to the bxp-cli.examples.json the desktop app offers templates from. |
BXP_DIAGNOSTIC |
Set to 1 to write a diagnostic trace (plus captured engine stderr) next to the preferences file — attach it when reporting a bug. |
BXP_GUI_MCP_HOST |
Bind host of the desktop app's agent-control server (default 127.0.0.1). The saved preference wins over this. |
BXP_GUI_MCP_PORT |
Bind port of the desktop app's agent-control server (default 7717). The saved preference wins over this. |
BXP_GUI_MCP_AUTO_APPROVE |
Seeds the auto-approve gate at startup, so an agent can drive a freshly launched app without a click. The persisted toggle is the one that survives across launches. |