BuildState

An AI-powered learning platform delivered through VS Code. Solve a mystery, learn AI/ML — one investigation at a time.

Features

Sidebar Dashboard

The investigation dashboard lives right in your VS Code sidebar — click the BuildState icon in the activity bar to open it. Track your progress, view case files, and uncover story fragments as you complete exercises.

Guided Exercises

Download task boilerplates with a single click. Each exercise comes with starter code, a companion AI brief, and a clear mission objective.

Environment Detection

The extension automatically detects your development environment (Node.js, Claude CLI) and reports readiness to the platform — so you always know you're set up correctly.

Secure Authentication

Connect your platform account through a browser-based login flow. Credentials are stored securely in VS Code's encrypted SecretStorage.

Deep Links

Open exercises directly from your browser or email links. The extension handles vscode:// URIs to download and open tasks automatically.

Getting Started

1. Install the extension from the VS Code Marketplace
2. Click the BuildState icon in the activity bar (left sidebar) — a "Connect Account" button will appear
3. Connect your account — click the button or run BuildState: Connect Account from the Command Palette
4. Start learning — the dashboard loads automatically after login. Download your first exercise and begin the investigation

Commands

Settings

Requirements

• VS Code 1.108 or later
• Node.js 18 or later (for running exercises)
• A valid BuildState platform account (provided with your cohort enrollment)

Privacy

• Your API token is stored in VS Code's encrypted SecretStorage
• Environment detection results (Node.js version, CLI availability) are sent to the platform to track setup progress
• No telemetry or usage data is collected by the extension itself

Support

Having trouble? Open an issue on GitHub.

License

Proprietary — see LICENSE for details.