CLI Overview

The devteam-orchestrator-cli package provides a command-line interface for interacting with DevTeam Orchestrator. It supports task execution, plan management, template deployment, and real-time status monitoring.

Installation

npm install -g devteam-orchestrator-cli

Authentication

# Interactive login (opens browser)
devteam login
 
# API key login
devteam login --api-key dtk_live_abc123
 
# Check auth status
devteam whoami
# Logged in as dev@example.com (admin)
# API: https://devteam.marsala.dev
# Token expires: 2026-03-20

Quick Start

# Run a single task
devteam run "Summarize this text" --model sonnet --wait
 
# Create and execute a plan
devteam plan create --file workflow.yaml
devteam plan run dt_plan_xyz789 --input data=@./input.json --wait
 
# Deploy a template
devteam templates deploy contract-review-v1 --input contract=@./contract.pdf
 
# Check status
devteam status dt_task_abc123
 
# View logs
devteam logs dt_task_abc123 --follow

Global Options

These flags are available on all commands:

Flag	Short	Description
`--api-url`		Override the API URL
`--api-key`		Override the API key
`--profile`	`-p`	Use a named configuration profile
`--output`	`-o`	Output format: `text`, `json`, `table`. Default: `text`
`--verbose`	`-v`	Enable debug logging
`--quiet`	`-q`	Suppress non-essential output
`--no-color`		Disable colored output
`--help`	`-h`	Show help for a command
`--version`	`-V`	Show CLI version

Output Formats

All commands support three output formats:

# Human-readable text (default)
devteam status dt_task_abc123
 
# JSON (for scripting)
devteam status dt_task_abc123 -o json
 
# Table (for lists)
devteam templates list -o table

Use -o json when piping output to other tools like jq for programmatic processing.

Configuration

# View current config
devteam config list
 
# Set defaults
devteam config set default-model sonnet
devteam config set default-queue gpu-queue
 
# Manage profiles
devteam config profile create staging --api-url https://staging.devteam.marsala.dev
devteam config profile use staging
devteam config profile list

Configuration is stored in ~/.devteam/config.json.

Next Steps

Commands Reference -- All CLI commands in detail
CLI Examples -- Real-world usage patterns

Type Reference Commands Reference