Commands Reference

devteam run

Execute a single task.

devteam run <prompt> [options]

Option	Description	Default
`--model`, `-m`	Model to use	`sonnet`
`--queue`, `-q`	Task queue	`default`
`--system`	System prompt	--
`--context`	JSON context object	--
`--priority`	Priority 1-10	`5`
`--timeout`	Timeout in seconds	`300`
`--tags`	Comma-separated tags	--
`--wait`, `-w`	Wait for completion	`false`
`--max-tokens`	Max response tokens	--
`--temperature`	Sampling temperature	--
`--output`, `-o`	Output format	`text`

Examples

# Simple task
devteam run "Explain microservices" --model sonnet --wait
 
# With system prompt and context
devteam run "Analyze this code for vulnerabilities" \
  --system "You are a senior security engineer" \
  --context '{"language": "typescript", "framework": "express"}' \
  --model opus \
  --tags security,code-review \
  --wait
 
# Pipe input from file
cat document.txt | devteam run "Summarize this document" --wait
 
# Read from file using @ syntax
devteam run "Review this contract" --context contract=@./contract.txt --wait

devteam plan

Manage and execute DAG workflow plans.

devteam plan create

devteam plan create --file <path> [options]

Option	Description
`--file`, `-f`	Path to YAML or JSON plan definition
`--name`	Override plan name
`--tags`	Comma-separated tags

devteam plan create --file workflow.yaml --tags production,legal
# Plan dt_plan_xyz789 created (4 steps)

devteam plan run

devteam plan run <plan-id> [options]

Option	Description	Default
`--input`, `-i`	Input key=value pairs (use @file for file content)	--
`--wait`, `-w`	Wait for completion	`false`
`--timeout`	Timeout in seconds	`300`
`--hitl`	Enable HITL for steps (comma-separated)	--
`--hitl-threshold`	Confidence threshold	`0.85`
`--verbose`	Show step-by-step progress	`false`

devteam plan run dt_plan_xyz789 \
  --input contract=@./contract.txt jurisdiction="New York" \
  --hitl analyze-risk \
  --hitl-threshold 0.9 \
  --wait \
  --verbose

devteam plan list

devteam plan list [options]

Option	Description
`--tags`	Filter by tags
`--limit`	Max results (default: 20)
`--output`, `-o`	Output format

devteam plan status

devteam plan status <execution-id>

Output:

Execution: dt_exec_abc123
Plan: contract-review-pipeline (dt_plan_xyz789)
Status: running
Progress: 2/4 steps complete

Steps:
  extract          completed   3.2s   sonnet
  analyze-risk     running     ...    opus
  check-compliance running     ...    sonnet
  generate-report  pending     ...    sonnet

Tokens: 1,847 in / 1,203 out
Cost: $0.018 (estimated total: $0.034)

devteam templates

Manage workflow templates.

devteam templates list

devteam templates list [options]

Option	Description
`--industry`	Filter by industry
`--search`	Search by name/description
`--tags`	Filter by tags
`--output`, `-o`	Output format

devteam templates list --industry legal -o table

Output:

ID                     Name                    Steps  Est. Cost  Industry
contract-review-v1     Contract Review         4      $0.034     legal
compliance-audit-v1    Compliance Audit        5      $0.051     legal
nda-generator-v1       NDA Generator           3      $0.022     legal
ip-assessment-v1       IP Assessment           6      $0.068     legal

devteam templates deploy

devteam templates deploy <template-id> [options]

Option	Description
`--input`, `-i`	Input key=value pairs
`--model-override`	Override model for a step (step=model)
`--wait`, `-w`	Wait for completion
`--timeout`	Timeout in seconds

devteam templates deploy contract-review-v1 \
  --input contract=@./contract.pdf jurisdiction="Delaware" \
  --model-override analyze-risk=opus \
  --wait

devteam templates info

devteam templates info <template-id>

Shows full template details including steps, input schema, and estimated costs.

devteam status

Check the status of any task or execution.

devteam status <id>

Automatically detects whether the ID is a task, plan, or execution.

devteam status dt_task_abc123
devteam status dt_exec_xyz789

devteam logs

View task execution logs.

devteam logs <id> [options]

Option	Description
`--follow`, `-f`	Stream logs in real time
`--tail`, `-n`	Show last N lines
`--step`	Filter by step ID (for plans)

# Follow logs for a running task
devteam logs dt_task_abc123 --follow
 
# View plan step logs
devteam logs dt_exec_xyz789 --step analyze-risk

devteam approvals

Manage HITL approval queue.

devteam approvals list

devteam approvals list [options]

Option	Description
`--queue`	Filter by queue
`--tags`	Filter by tags
`--expired`	Include expired approvals

devteam approvals approve

devteam approvals approve <task-id> [options]

Option	Description
`--comment`	Reviewer comment
`--modified-output`	Provide corrected output

devteam approvals reject

devteam approvals reject <task-id> [options]

Option	Description
`--reason`	Rejection reason (required)
`--retry`	Retry with feedback

devteam approvals reject dt_task_abc123 \
  --reason "Missing indemnification analysis" \
  --retry

devteam config

Manage CLI configuration.

devteam config list                    # Show all settings
devteam config set <key> <value>       # Set a value
devteam config get <key>               # Get a value
devteam config profile create <name>   # Create a profile
devteam config profile use <name>      # Switch profiles
devteam config profile list            # List profiles
devteam config profile delete <name>   # Delete a profile

devteam doctor

Run system diagnostics.

devteam doctor

devteam doctor checks your Node.js version, network connectivity, authentication status, and Temporal reachability. Run it when troubleshooting connection issues.

devteam whoami

Show the current authenticated user and configuration.

devteam whoami
# Email: dev@example.com
# Role: admin
# API: https://devteam.marsala.dev
# Profile: production
# Token expires: 2026-03-20T10:00:00Z

Next Steps

CLI Examples -- Real-world usage patterns and scripts

Overview Examples