CLI Reference

# Generate with automatic agent routing
dojops "Create a Terraform config for S3 with versioning"
dojops "Write a Kubernetes deployment for nginx with 3 replicas"
dojops "Set up monitoring with Prometheus and alerting rules"
dojops "Create a multi-stage Dockerfile for a Go application"
 
# Update existing configs (auto-detects existing files, creates .bak backup)
dojops "Add caching to the GitHub Actions workflow"
dojops "Add a Redis service to docker-compose"
dojops "Add an S3 bucket to the existing Terraform config"
 
# Override provider/model for a single command
dojops --provider=anthropic "Create a Helm chart for Redis"
dojops --model=gpt-4o "Design a VPC with public and private subnets"
 
# Force a specific tool (bypass agent routing)
dojops --tool=terraform "Create an S3 bucket with versioning"
dojops --tool=kubernetes "Create a deployment for nginx"

# Decompose a complex goal into tasks
dojops plan "Set up CI/CD for a Node.js app with Docker and Kubernetes"
 
# Plan and execute immediately
dojops plan --execute --yes "Create CI pipeline for a Python project"
 
# Execute a saved plan
dojops apply
dojops apply --dry-run          # preview only
dojops apply --skip-verify      # skip external validation (on by default)
dojops apply --force            # skip git dirty working tree check
dojops apply --allow-all-paths  # bypass DevOps file write allowlist
dojops apply --resume --yes     # resume failed tasks, auto-approve
dojops apply --replay           # deterministic: temp=0, validate env match
dojops apply --replay --yes     # force replay despite mismatches
 
# Force a specific tool for planning or execution
dojops --tool=terraform plan "Set up S3 with CloudFront"
dojops apply plan-abc --tool=terraform   # only run terraform tasks from plan

# Debug CI failures
dojops debug ci "ERROR: tsc failed with exit code 1..."
dojops debug ci "npm ERR! ERESOLVE unable to resolve dependency tree"
 
# Analyze infrastructure diffs
dojops analyze diff "terraform plan output..."
dojops explain last

# Analyze detected DevOps files for quality, security, and best practices
dojops check
 
# Machine-readable output
dojops check --output json

# Full project scan
dojops scan
 
# Targeted scans
dojops scan --security          # trivy + gitleaks
dojops scan --deps              # npm-audit + pip-audit
dojops scan --iac               # checkov + hadolint
dojops scan --sbom              # generate SBOM with hash tracking
 
# Compare with previous scan
dojops scan --compare
 
# Auto-remediation
dojops scan --fix --yes

# Start a new session
dojops chat
 
# Named session with agent pinning
dojops chat --session=infra --agent=terraform
 
# Resume the most recent session
dojops chat --resume

# Check available toolchain binaries
dojops toolchain list
 
# Install external validators
dojops toolchain install terraform
dojops toolchain install kubectl
dojops toolchain install hadolint
 
# Cleanup
dojops toolchain clean

# List discovered custom tools (global + project)
dojops tools list
 
# Scaffold a new custom tool
dojops tools init my-tool
 
# Validate a custom tool manifest
dojops tools validate .dojops/tools/my-tool/
 
# Publish a tool to DojOps Hub (requires DOJOPS_HUB_TOKEN)
dojops tools publish my-tool.dops --changelog "Initial release"
 
# Install a tool from DojOps Hub
dojops tools install nginx-config
dojops tools install nginx-config --version 1.0.0 --global
 
# Search the DojOps Hub for tools
dojops tools search docker
dojops tools search terraform --limit 5
dojops tools search k8s --output json

# 1. Sign in at hub.dojops.ai → Settings → API Tokens
# 2. Generate a token (format: dojops_<40-hex-chars>)
# 3. Set the environment variable:
export DOJOPS_HUB_TOKEN="dojops_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
 
# Publish a tool
dojops tools publish my-tool.dops
 
# Publish with changelog
dojops tools publish my-tool.dops --changelog "v1.1.0: Added Redis support"
 
# Install from hub (no token required)
dojops tools install my-tool
dojops tools install my-tool --version 1.0.0 --global

# List all providers with status
dojops provider
dojops provider list --output json
 
# Add providers
dojops provider add openai --token sk-...
dojops provider add anthropic --token sk-ant-...
 
# Switch default provider
dojops provider switch                 # interactive picker
dojops provider default anthropic      # direct
dojops provider --as-default openai    # shortcut flag
 
# Remove a provider
dojops provider remove deepseek

# System diagnostics
dojops doctor
 
# Browse agents
dojops agents list
dojops agents info terraform-specialist
 
# Create custom agents
dojops agents create "an SRE specialist for incident response"
dojops agents create --manual
dojops agents remove sre-specialist
 
# Audit trail
dojops history list
dojops history show plan-abc123
dojops history verify
 
# Start dashboard
dojops serve --port=8080
 
# Generate API credentials and start with auth
dojops serve credentials             # generates key, saves to ~/.dojops/server.json
dojops serve                         # auto-loads key from server.json
 
# Configuration profiles
dojops config profile create staging
dojops config profile use staging
dojops config profile list