DevBoxer CLI

The official CLI for DevBoxer - your AI-powered coding assistant.

Installation

# Using npm
npm install -g @devboxer/cli

# Using pnpm
pnpm add -g @devboxer/cli

# Using yarn
yarn global add @devboxer/cli

Commands

devboxer auth

Authenticate with your DevBoxer account. This will:

1. Open your browser for authentication
2. Generate a secure token
3. Store credentials safely in ~/.devboxer/config.json (configurable via DEVBOXER_SETTINGS_DIR)
4. Confirm successful connection

devboxer auth

Configuration directory

By default, credentials are stored in ~/.devboxer/config.json. You can override the settings directory by setting the DEVBOXER_SETTINGS_DIR environment variable:

# Example: use a custom settings directory
export DEVBOXER_SETTINGS_DIR=~/.config/devboxer
devboxer auth

devboxer create

Create a new task in DevBoxer with a message:

# Create a task in the current repository and branch
devboxer create "Fix the login bug"

# Specify a different repository
devboxer create "Add new feature" --repo owner/repo

# Use a specific base branch
devboxer create "Update documentation" --branch develop

# Use existing branch without creating a new one
devboxer create "Quick fix" --no-new-branch

# Start in plan mode (no file writes until approval)
devboxer create "Refactor the auth module" --mode plan

# Choose a specific model
devboxer create "Investigate flaky tests" --model sonnet
devboxer create "Run large codegen" --model gpt-5-high
> GPT-5.1 Codex Max variants require a ChatGPT subscription connected in Settings.

Options

• -r, --repo <repo>: GitHub repository (default: current repository)
• -b, --branch <branch>: Base branch name (default: current branch, falls back to main)
• --no-new-branch: Don't create a new branch (default: creates new branch)
• -m, --model <model>: AI model to use: opus, claude-opus-4-6, sonnet, haiku, amp, gpt-5-low, gpt-5-medium, gpt-5, gpt-5-high, gpt-5.2-low, gpt-5.2-medium, gpt-5.2, gpt-5.2-high, gpt-5.4-low, gpt-5.4-medium, gpt-5.4, gpt-5.4-high, gpt-5.4-xhigh, gpt-5.1-low, gpt-5.1-medium, gpt-5.1, gpt-5.1-high, gpt-5.1-codex-max-low, gpt-5.1-codex-max-medium, gpt-5.1-codex-max, gpt-5.1-codex-max-high, gpt-5.1-codex-max-xhigh, gpt-5-codex-low, gpt-5-codex-medium, gpt-5-codex-high, gpt-5.2-codex-low, gpt-5.2-codex-medium, gpt-5.2-codex-high, gpt-5.2-codex-xhigh, gpt-5.3-codex, gpt-5.3-codex-low, gpt-5.3-codex-medium, gpt-5.3-codex-high, gpt-5.3-codex-xhigh, gemini-3.1-pro-preview, gemini-3-pro, gemini-2.5-pro, grok-code, qwen3-coder, kimi-k2, glm-4.6, opencode/gemini-2.5-pro (optional)
• -M, --mode <mode>: Task mode: plan or execute (default: execute)

devboxer pull

Pull tasks from DevBoxer to your local machine:

# Interactive mode - select from recent tasks
devboxer pull

# Pull a specific task by ID
devboxer pull <taskId>

# Pull and automatically launch Claude Code
devboxer pull <taskId> --resume

Getting the task ID: You can find the task ID at the end of the URL when viewing a task in DevBoxer. For example, in https://devboxer.com/tasks/abc123-def456, the task ID is abc123-def456.

Options

• -r, --resume: Automatically launch Claude Code after pulling

devboxer list

List all tasks in a non-interactive format:

# List all tasks (automatically filters by current repo when inside a Git repository)
devboxer list

Example Output

Task ID         abc123def456
Name            Fix login bug
Branch          devboxer/fix-login
Repository      myorg/myrepo
PR Number       #123

Task ID         def789ghi012
Name            Add dark mode
Branch          devboxer/dark-mode
Repository      myorg/myrepo
PR Number       N/A

Total: 2 tasks

devboxer mcp

Run an MCP (Model Context Protocol) server for the git repository:

# Run MCP server for current directory
devboxer mcp

Claude Code Integration

You can add the DevBoxer MCP server to your local Claude Code instance to enable direct interaction with DevBoxer tasks from within Claude:

claude mcp add devboxer -- devboxer mcp

This integration provides Claude Code with the following capabilities:

• devboxer_list: List all your DevBoxer tasks directly from Claude
• devboxer_create: Create new tasks without leaving Claude Code
• devboxer_pull: Pull task session data to continue work

The MCP server acts as a bridge between Claude Code and DevBoxer, allowing you to manage tasks using natural language commands within your AI coding sessions.

Support

• Documentation: https://www.devboxer.com/docs
• Website: https://devboxer.com