Getting Started
Get BuilderBox up and running in under 2 minutes. Install the extension, sign in, and start tracking!
Prerequisites
- • A BuilderBox account (free)
- • VS Code, Cursor, or Windsurf editor
Install the VS Code Extension
Choose your preferred method
From Marketplace
Search for "BuilderBox" in the VS Code Extensions panel, or click the button below.
Install from MarketplaceFrom Command Line
Install directly using the VS Code CLI.
code --install-extension builderbox.builderboxWorks with AI-Powered Editors
The extension works in VS Code, Cursor, and Windsurf. Just install from the marketplace within your editor.
Sign In
Connect your BuilderBox account
After installing the extension, you'll see a notification prompting you to sign in:
- 1 Click "Sign In" in the notification
- 2 Your browser opens to authorize
- 3 Click "Authorize" — you're redirected back automatically
That's it! The extension automatically receives your API key and starts tracking.
Start Coding
Make sure everything is working
In Your Editor
- Look for the BuilderBox icon in your status bar — it shows "connected"
- Open Command Palette (Cmd+Shift+P) and type "BuilderBox: Show Status"
- Start coding! Activity will appear in your dashboard within a few minutes.
CLI (Optional)
For power users and scripting
The CLI is optional but provides additional features like viewing stats from the terminal, task management, and headless authentication.
macOS / Linux
curl -fsSL https://builder-box.com/install.sh | shWindows
irm https://builder-box.com/install.ps1 | iex