Setup VS Code

Requirements

• VS Code 1.85+
• network access during the first managed-runtime installation

Build From Source

From the repository root:

bun install
bun --cwd packages/extensions/vscode-v2 run package

The package command writes a VSIX into packages/extensions/vscode-v2.

Install VSIX

code --install-extension /absolute/path/to/alphabase-v2-<version>.vsix --force

Extension ID: alphabase.alphabase-v2

The extension downloads a compatible, checksum-verified AlphaBase runtime on first start and caches it for offline reuse. Stable extensions use the stable runtime channel; prerelease extensions use the isolated prerelease channel. Installation is atomic, and a failed update rolls back to the last verified compatible runtime. alphabaseV2.binaryPath remains an advanced override for local development and troubleshooting.

Open Chat

• activity bar AlphaBase icon
• command: Open AlphaBase
• shortcut: Cmd+L / Ctrl+L

Key Commands

• alphabaseV2.newSession
• alphabaseV2.restart
• alphabaseV2.cancelGeneration
• alphabaseV2.switchModel
• alphabaseV2.switchMode
• alphabaseV2.exportConversation
• alphabaseV2.healthCheck
• alphabaseV2.openSetupWizard

See IDE for the full command/settings reference.

Runtime Validation

Run one simple write task and verify:

1. streaming activity appears in timeline
2. write artifact is attached to the turn
3. final completion response is shown

If this sequence breaks, open Runtime Diagnostics.