Dragon CLI & MCP

GitHub Packages:@devdocsorg/dragon-cli

Dragon lets you work with DevDocs tasks directly from the command line. Create tasks, review changes, and pull task sessions to continue locally.

Requirements

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

Installation

Dragon is published through the DevDocs GitHub Packages registry. Configure the DevDocs scope once with your GitHub Packages token while leaving the default npm registry available for Dragon's public dependencies:

npm config set @devdocsorg:registry https://npm.pkg.github.com
npm login --scope=@devdocsorg --registry=https://npm.pkg.github.com

# Using npm
npm install -g @devdocsorg/dragon-cli

# Using pnpm
pnpm add -g @devdocsorg/dragon-cli

# Using yarn
yarn global add @devdocsorg/dragon-cli

Authentication

dragon auth

This will:

You can override the default settings directory by setting the DRAGON_SETTINGS_DIR environment variable before running the CLI:

export DRAGON_SETTINGS_DIR=~/.config/dragon
dragon auth

Commands

dragon create

Create a new task in DevDocs with a message.

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

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

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

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

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

# Create a task in plan mode (for complex tasks requiring planning)
dragon 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 family: gpt-5.2, gpt-5.2-medium, gpt-5.2-low, gpt-5.2-high
• gpt-5.1 family: gpt-5.1, gpt-5.1-medium, gpt-5.1-low, gpt-5.1-high
• Codex Max via the gpt-5.1-codex-max family: gpt-5.1-codex-max, 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 via the gpt-5.1-codex family: gpt-5.1-codex, gpt-5.1-codex-medium, gpt-5.1-codex-low, gpt-5.1-codex-high
• gpt-5 family: gpt-5, gpt-5-medium, gpt-5-low, gpt-5-high
• GPT-5 Codex via the gpt-5-codex family: gpt-5-codex, gpt-5-codex-medium, gpt-5-codex-low, 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

dragon pull

Pull tasks from DevDocs to your local machine:

# Interactive mode - select from recent tasks
dragon pull

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

# Pull and automatically launch Claude Code
dragon 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)

dragon list

List all tasks in a non-interactive format:

# List all tasks (automatically filters by current repo when inside a Git repository)
dragon 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          terragon/fix-login
Repository      myorg/myrepo
PR Number       #123

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

Total: 2 tasks

dragon mcp

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

# Run MCP server for current directory
dragon mcp

Claude Code Integration

You can add the Dragon MCP server to Claude Code to manage DevDocs tasks from within your coding session:

claude mcp add dragon -- dragon mcp

This integration provides Claude Code with the following capabilities:

• dragon_list: List your DevDocs tasks
• dragon_create: Create a DevDocs task
• dragon_boards: Read the task board for a repository
• dragon_pull: Pull task session data to continue work

The MCP server connects Claude Code to your DevDocs tasks through natural language commands.