DevBoxer CLI & MCP

The DevBoxer CLI let's you interact with DevBoxer directly from the command line. Create tasks, review changes, pull tasks to pick up where you left off, all from your terminal.

Requirements

• macOS, Linux, or WSL (Windows Subsystem for Linux)
• Node.js 18+ or newer
• npm package manager (bun is not currently supported)

Installation

npm install -g @devboxer/cli

Authentication

devboxer auth

This will:

You can override the default settings directory by setting the DEVBOXER_SETTINGS_DIR environment variable before running the CLI. For example:

export DEVBOXER_SETTINGS_DIR=~/.config/devboxer
devboxer auth

Commands

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

# Use a specific AI model
devboxer create "Refactor code" --model opus

# Create a task in plan mode (for complex tasks requiring planning)
devboxer create "Build new authentication system" --mode plan

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, --mode <mode>: Whether to create tasks in plan mode (require approval before making changes) or execution mode. Only available with the Claude Code agent (default: execute)
• -m, --model <model>: AI model to use (default: last model you selected in the dashboard)

Available models:

• sonnet
• haiku
• opus
• gpt-5.2 (or gpt-5.2-medium)
• gpt-5.2-low
• gpt-5.2-high
• gpt-5.1 (or gpt-5.1-medium)
• gpt-5.1-low
• gpt-5.1-high
• gpt-5.1-codex-max (or gpt-5.1-codex-max-medium)
• gpt-5.1-codex-max-low
• gpt-5.1-codex-max-high
• gpt-5.1-codex-max-xhigh
• gpt-5.1-codex-low
• gpt-5.1-codex-medium (or gpt-5.1-codex)
• gpt-5.1-codex-high
• gpt-5 (or gpt-5-medium)
• gpt-5-low
• gpt-5-high
• gpt-5-codex-low
• gpt-5-codex-medium (or gpt-5-codex)
• gpt-5-codex-high
• gemini-3-pro
• gemini-2.5-pro
• opencode/grok-code (or grok-code)
• opencode/qwen3-coder (or qwen3-coder)
• opencode/kimi-k2 (or kimi-k2)
• opencode/glm-4.6 (or glm-4.6)
• opencode/gemini-2.5-pro
• amp

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

Options

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

Task Display

Once selected, each task shows:

• Task title
• Branch name
• Repository
• PR # (if available)

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

Task Display

Each task shows:

• Task ID
• Name
• Branch
• Repository
• PR # (if available)

A count of your active tasks is returned after all of your tasks are listed.

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.