CLI Reference

CLI Commands

Complete reference for all BuilderBox CLI commands. The CLI handles authentication, code tracking setup, task management, and more.

Installation

macOS / Linux

curl -fsSL https://builder-box.com/install.sh | sh

Windows (PowerShell)

irm https://builder-box.com/install.ps1 | iex

Authentication

Manage your BuilderBox authentication

builderbox auth login

builderbox auth login -k <key>

builderbox auth logout

Log out and clear credentials

builderbox auth status

Check authentication status

Code Tracking

View and manage code tracking

builderbox code status

Check tracking status

builderbox code stats

View coding statistics summary

builderbox code export

Export coding activity data

Tasks

Manage your tasks from the command line

builderbox task list

List all tasks

builderbox task list --inbox

List inbox tasks only

builderbox task show <id>

Show task details

builderbox task add "Title"

Create a new task

builderbox task complete <id>

Mark task as complete

Calendar

View upcoming tasks and deadlines

builderbox calendar today

Today's tasks and overdue items

builderbox calendar upcoming

Upcoming tasks (next 7 days)

API Keys

Manage API keys for extensions and MCP

builderbox key list

List all API keys

builderbox key create

Create a new key (uses hostname)

builderbox key create -n "Name"

Create a key with custom name

builderbox key delete <id>

Delete an API key

builderbox key rename <id> "Name"

Rename an API key

Updates

Keep your CLI up to date

builderbox update

Update CLI to latest version

builderbox --version

Show current CLI version

Configuration

BuilderBox stores its configuration in your home directory:

~/.builderbox/config.json Main configuration file

~/.builderbox/bin/ CLI binary location

API Key Usage

API keys created with the CLI can be used for:

BuilderBox VS Code/Cursor extension authentication
MCP server authentication for AI assistants
CLI authentication with builderbox auth login -k <key>

You can also create and manage API keys from the Settings page in the web app.

Getting Help

Use the --help flag with any command to see detailed usage information:

builderbox --help
builderbox auth --help
builderbox task add --help