Extension

VS Code Extension

Track your coding time with accurate AI vs Human attribution. Works with VS Code, Cursor, Windsurf, and other VS Code-based editors.

Supported Editors

󰨞

VS Code

⌘

Cursor

🏄

Windsurf

📊

Positron

◯

Void

🔓

VSCodium

Installation

From Marketplace

Open VS Code, Cursor, or Windsurf
Go to Extensions (Cmd+Shift+X)
Search for "BuilderBox"
Click Install

View on Marketplace

From Command Line

code --install-extension builderbox.builderbox

For Cursor, use cursor instead of code.

One-Click Setup

After installing the extension, you'll be prompted to sign in. Click "Sign In" and authorize in your browser — no CLI commands needed!

The extension will automatically create your API key and start tracking.

How It Works

BuilderBox tracks your coding activity by monitoring document changes in your editor. When you accept an AI completion or an AI agent makes changes, BuilderBox detects it through:

Native APIs

For tools like Copilot and Cursor that expose completion events

Extension APIs

Monitoring when AI extensions are active

Heuristics

Detecting large changes without recent keystrokes

Commands

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and type "BuilderBox":

BuilderBox: Show Status

View connection status and current session stats

BuilderBox: Open Dashboard

Open your coding dashboard in browser

BuilderBox: Toggle Tracking

Enable/disable time tracking

BuilderBox: Sign In

Settings

Configure the extension in VS Code Settings (Cmd+,) or edit settings.json directly.

General Settings

Setting	Default	Description
`builderbox.enabled`	`true`	Enable or disable time tracking
`builderbox.apiUrl`	`https://builder-box.com`	API URL (for self-hosted instances)
`builderbox.debug`	`false`	Enable debug logging
`builderbox.idleCutoffMinutes`	`15`	Stop presence tracking after this many minutes of inactivity

AI Detection Settings

Setting	Default	Description
`builderbox.aiDetection.enabled`	`true`	Enable AI code detection
`builderbox.aiDetection.minCharsForAI`	`50`	Minimum characters to consider AI-generated
`builderbox.aiDetection.minTimeWithoutKeystrokeMs`	`500`	Minimum ms since keystroke for AI detection
`builderbox.aiDetection.agentMinChars`	`30`	Minimum characters for AI agent detection when unfocused
`builderbox.aiDetection.collectTrainingData`	`false`	Collect anonymized training data to improve AI detection (opt-in)

Privacy

Your actual code is never sent to our servers. We only collect:

File paths and extensions
Line/character counts
Timing information
AI tool attribution
Editor and OS info