Embed a self-hosted code-server or VS Code Server instance in BB's right panel. Each launch opens an independent VS Code 1, VS Code 2, and so on tab.
- BB 0.41 or later.
- A reachable HTTP or HTTPS code-server or VS Code Server URL.
- The server's authentication and network controls must permit the BB client that will load it.
Install from the plugin's Git repository after its first release:
rift plugin install git:https://github.com/GantisStorm/bb-plugin-vscode-server.git@semver:^0.1.0Set the URL in BB settings:
rift plugin config vscode-server set serverUrl https://code.example.comAlternatively, set VSCODE_SERVER_URL in BB's server environment. The plugin setting takes precedence. Empty settings and environment values leave the panel unconfigured.
The plugin settings also show the desktop VS Code profile and extension directories, plus the code-server target directories. Saving a loopback URL in the setting—or using Detect local server—imports the selected profile and extensions into those target directories. Start code-server with matching --user-data-dir and --extensions-dir options. Remote URLs embed normally but cannot receive files from this machine. The URL must be absolute HTTP or HTTPS and must not contain credentials; the plugin removes a trailing slash before embedding it.
In any thread, open the right panel, choose Open new tab, then select VS Code. A thread has one VS Code panel; reopening it focuses that panel. The panel opens code-server at the thread environment’s workspace; threads without an environment open at their BB thread-storage folder. Its compact header expands when clicked to reveal the server URL, profile import status, and Open in Browser. It reloads its configuration when opened; use Reload configuration after changing the setting while it is already open. In the plugin settings, turn on Capture local server to restore the standard VS Code profile paths, then detect code-server or VS Code Server on ports 8080 and 8000 and save the first healthy endpoint. Turn the switch off to clear every plugin setting. Turn it back on to restore the paths and capture again. When no URL is configured, Detect local server in the panel performs the same capture. Open in Browser delegates the URL to BB's native Browser, whose tabs remain available across thread navigation.
npm install
rift plugin build
npx vitest run server.test.ts
rift plugin install .dist/ is committed because Git installations load the prebuilt plugin artifacts. rift plugin types synchronizes development declarations with the BB instance used for development; the checked-in SDK declaration version is the latest published package compatible with the plugin's declared BB runtime requirement.
The plugin embeds the configured URL in an iframe and copies local profile files only for loopback URLs. It does not proxy requests or weaken the server's existing authentication. Configure code-server with HTTPS and its normal authentication controls when it is accessible outside a trusted network.
Maintained for Rift. Original source and credit: GantisStorm/bb-plugin-vscode-server. Original licensing and attribution are preserved. Use npm ci and npm run build; the pinned SDK artifact is documented in vendor/README.md.