bgng ide
All IDE commands support --json. JSON output is load-bearing because the VSCode extension consumes it.
Install, update, repair
bgng ide install
bgng ide update
bgng ide repair
install and update install the bundled VSIX into the stock VSCode extensions directory. repair reinstalls only when the expected install directory is missing.
Connect
bgng ide connect --mode beginningdb.direct --id local-dev --label "Local dev" --base-url http://127.0.0.1:8080 --tenant-id 1 --filesystem-id main
bgng ide connect --mode iminds.gateway --id staging --label "Staging" --gateway-url https://gateway.example.com --filesystem-id main
bgng ide connect ... --verify
Direct profiles require --base-url, --tenant-id, and --filesystem-id. Gateway profiles require --gateway-url and --filesystem-id.
Login
bgng ide login --profile local-dev --token "Bearer ..."
bgng ide login --profile staging --token "manual gateway token"
bgng ide login --profile staging --gateway-access-token "<access>" --gateway-refresh-token "<refresh>"
bgng ide login --profile staging --hub-base-url https://hub.example.com --dispatch-url https://dispatch.example.com --tenant-id "42" --account-id "acct-..." --hub-access-token "<access>" --hub-refresh-token "<refresh>"
The flag set determines whether the stored strategy is direct bearer, manual gateway token, managed session, or dispatch session.
Open and doctor
bgng ide open --profile staging --workspace "$PWD"
bgng ide doctor
bgng ide doctor --json
open writes runtime metadata and launches VSCode. doctor probes profiles and reports auth/connectivity status.
Profiles
bgng ide profiles list
bgng ide profiles show staging
bgng ide profiles resolve staging --json
bgng ide profiles remove staging
resolve --json returns the profile plus resolved auth and is the canonical extension contract.
Auth
bgng ide auth refresh --profile staging
bgng ide auth refresh --profile staging --verify
bgng ide auth clear --profile staging
Refresh is a no-op for manual gateway tokens and unavailable for direct bearers. Managed and dispatch gateway sessions can rotate stored access material.