IDE Control Plane
The IDE control plane lets bgng install the BeginningDB VSCode extension, manage profiles, store auth, refresh gateway sessions, and hand resolved profile JSON to the extension.
Install the extension
bgng ide install
bgng ide install --json
install locates the target VSCode extensions directory, locates the bundled VSIX, removes any previous install of the same extension id, and unzips the new version. bgng ide update currently runs the same path. bgng ide repair reinstalls only when the expected install directory is missing.
Connect profiles
Direct BeginningDB:
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
Gateway worker:
bgng ide connect --mode iminds.gateway --id staging --label "Staging" --gateway-url https://gateway-worker.example.com --filesystem-id main
Add --verify to probe connectivity before saving. Failed verification prevents the profile from being written.
Login
Direct profile:
bgng ide login --profile local-dev --token "Bearer xyz123"
Gateway manual token:
bgng ide login --profile staging --token "pasted-token"
Gateway managed session:
bgng ide login --profile staging --gateway-access-token "<access>" --gateway-refresh-token "<refresh>"
Gateway dispatch session:
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>"
Open and diagnose
bgng ide open --profile staging --workspace "$HOME/work/myproject"
bgng ide profiles list
bgng ide profiles resolve staging --json
bgng ide doctor
profiles resolve --json is the canonical contract the VSCode extension parses.
Refresh and clear auth
bgng ide auth refresh --profile staging
bgng ide auth refresh --profile staging --verify
bgng ide auth clear --profile staging
Manual tokens are not refreshable. Direct bearers are not refreshable. Managed and dispatch gateway sessions can be refreshed using stored refresh material.