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 adjust a single launch. Where one overlaps a saved setting (the agent-control host / port), the saved preference wins; the settings inspector shows a BXP_CLI_PATH override when one is set.

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.