Skip to content

User preferences

Settings (theme, zoom level, recent files, custom places, and the agent-control server host / port / auto-approve / Origin allowlist) are stored in a single visible JSON file:

Platform Path
Linux ~/.local/share/bxp-gui/bxp-gui.json
macOS ~/Library/Application Support/bxp-gui/bxp-gui.json
Windows %APPDATA%\bxp-gui\bxp-gui.json

The file is auto-created on first write. Delete it to reset everything to defaults. Every persisted key is listed in User preferences (keys) — generated from the app's Prefs catalog.

The GUI takes no command-line flags — it reads this preferences file, and the environment variables override individual settings for a single launch (the settings inspector shows which ones are in effect).

There is deliberately no startup auto-load: bxp-gui always opens with an empty editor. The recent-files list is remembered across launches and seeds the open dialog (ctrl+o), so the last config you used is one click away — but nothing is opened behind your back after a restart.