CLI Reference

# Quick setup (bash)
dojops completion bash >> ~/.bashrc && source ~/.bashrc
 
# Quick setup (zsh)
dojops completion zsh >> ~/.zshrc && source ~/.zshrc
 
# Or let DojOps do it
dojops completion install

{
  "hooks": {
    "pre-generate": { "command": "echo 'Starting generation...'" },
    "post-generate": { "command": "./scripts/lint-output.sh" },
    "pre-plan": { "command": "git stash" },
    "post-plan": [
      { "command": "echo 'Plan complete'" },
      { "command": "./notify.sh", "continueOnError": true }
    ],
    "on-error": { "command": "./scripts/alert-failure.sh" }
  }
}

# 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 skill (bypass agent routing)
dojops --skill=terraform "Create an S3 bucket with versioning"
dojops --skill=kubernetes "Create a deployment for nginx"

# Read prompt from a file
dojops --file requirements.md
dojops -f spec.txt
 
# Combine inline prompt with file content (inline provides context, file provides details)
dojops --file infrastructure-spec.md "Use Terraform with AWS"
dojops plan -f cicd-requirements.txt "Target GitHub Actions"

# 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 skill for planning or execution
dojops --skill=terraform plan "Set up S3 with CloudFront"
dojops apply plan-abc --skill=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 (--file recommended for multiline)
dojops analyze diff --file plan.diff
terraform plan | dojops analyze diff
dojops explain last

# Analyze detected DevOps files for quality, security, and best practices
dojops check
 
# Machine-readable output
dojops check --output json
 
# Test provider connectivity
dojops check provider
dojops check provider --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
dojops scan --license           # license compliance check
 
# Compare with previous scan
dojops scan --compare
 
# Auto-remediation
dojops scan --fix --yes
 
# Scan a different directory
dojops scan --target /path/to/project
 
# Fail CI on severity threshold
dojops scan --fail-on MEDIUM

# 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
 
# Single message (non-interactive, scriptable)
dojops chat --message "What tools are missing in this project?"
dojops chat -m "Explain the CI pipeline" --output json

# 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 skills (global + project)
dojops skills list
 
# Scaffold a new .dops skill (uses AI when provider is configured)
dojops skills init my-skill
 
# Validate a custom skill
dojops skills validate my-skill
 
# Publish a skill to DojOps Hub (requires DOJOPS_HUB_TOKEN)
dojops skills publish my-skill.dops --changelog "Initial release"
 
# Install a skill from DojOps Hub
dojops skills install nginx-config
dojops skills install nginx-config --version 1.0.0 --global
 
# Search the DojOps Hub for skills
dojops skills search docker
dojops skills search terraform --limit 5
dojops skills 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 skill
dojops skills publish my-skill.dops
 
# Publish with changelog
dojops skills publish my-skill.dops --changelog "v1.1.0: Added Redis support"
 
# Install from hub (no token required)
dojops skills install my-skill
dojops skills install my-skill --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 (partial names supported: terraform, docker, security, etc.)
dojops agents list
dojops agents info terraform            # matches terraform-specialist
dojops agents info security             # matches security-auditor
 
# 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
 
# Start without authentication (local development only)
dojops serve --no-auth
 
# Enable HTTPS/TLS
dojops serve --tls-cert=cert.pem --tls-key=key.pem
 
# Configuration profiles
dojops config profile create staging
dojops config profile use staging
dojops config profile list
 
# Check for updates
dojops upgrade --check
 
# Upgrade to latest version
dojops upgrade
 
# Upgrade without confirmation
dojops upgrade --yes

dojops config get defaultProvider        # Read a value
dojops config set defaultProvider ollama  # Set a value
dojops config set tokens.openai sk-xxx   # Set nested value
dojops config delete tokens.deepseek     # Remove a key
dojops config validate                   # Check config health
 
# Backup and restore
dojops config backup                     # Save timestamped backup
dojops config restore                    # Interactive picker
dojops config export config.yaml         # Export to YAML
dojops config apply config.yaml          # Import from YAML/JSON

# Token usage analytics
dojops tokens
dojops tokens --output json
 
# Opportunity detection
dojops insights                          # Top 10 insights
dojops insights --all                    # Show everything
dojops insights security                 # Filter by category
 
# Project memory
dojops memory add "Always use t3.medium for staging"
dojops memory add "Terraform state in S3" --category=convention --keywords=terraform,s3
dojops memory list
dojops memory search terraform
dojops memory remove 3
dojops memory clear              # Delete all notes
 
# Auto-enrichment (memory from dojops auto runs)
dojops memory auto              # Check status
dojops memory auto on           # Enable
dojops memory auto off          # Disable
 
# Learned error patterns
dojops memory errors
 
# Pattern analysis (learn from execution history)
dojops learn summary                          # Quick overview
dojops learn patterns                         # Usage by command type
dojops learn rules --type generate            # Error patterns for generate
dojops learn resolve 5 "Fixed by pinning to gpt-4o"
dojops learn dismiss 3                        # Remove an error pattern

dojops cron add "0 2 * * *" plan "backup terraform"   # Schedule nightly plan
dojops cron add "*/30 * * * *" scan --security         # Scan every 30 min
dojops cron list                                        # View all jobs
dojops cron remove job-abc123                           # Remove a job

# Snapshot current state before risky changes
dojops checkpoint create before-refactor
 
# List checkpoints
dojops checkpoint list
 
# Restore a checkpoint
dojops checkpoint restore before-refactor
 
# Remove all checkpoints
dojops checkpoint clean
 
# Trust workspace configs (agents, MCP servers, skills)
dojops trust
dojops trust list
 
# Remove trust
dojops untrust

# Store API keys and tokens (AES-256-GCM encrypted)
dojops secrets set ANTHROPIC_API_KEY sk-ant-...
dojops secrets set AWS_ACCESS_KEY_ID AKIA...
 
# List stored secrets
dojops secrets list
 
# Retrieve (masked by default)
dojops secrets get ANTHROPIC_API_KEY
dojops secrets get ANTHROPIC_API_KEY --raw   # Full value
 
# Remove
dojops secrets remove AWS_ACCESS_KEY_ID

# Create a backup of .dojops/
dojops backup
dojops backup --output ~/backups
 
# List existing backups
dojops backup list
 
# Restore from a backup
dojops backup restore dojops-backup-2026-03-22.tar.gz
dojops backup restore dojops-backup-2026-03-22.tar.gz --verify

# Review all detected DevOps files
dojops review
 
# Review specific files
dojops review Dockerfile .github/workflows/ci.yml
 
# Review and auto-fix
dojops review --fix --yes
 
# JSON output for CI pipelines
dojops review --output json --non-interactive

# Estimate costs for Terraform configs
dojops cost
dojops cost --target ./infra/
 
# Detect drift between IaC and live state
dojops drift
dojops drift --target ./terraform/
 
# Auto-fix detected drift
dojops drift --fix
 
# Auto-remediate vulnerable dependencies
dojops fix-deps

# Generate and install completion
dojops completion install
 
# Or generate manually
dojops completion bash >> ~/.bashrc
dojops completion zsh >> ~/.zshrc

dojops skills dev my-tool.dops          # Validate a skill
dojops skills dev my-tool.dops --watch  # Watch mode

dojops chat export                       # Export all sessions as markdown
dojops chat export session-123           # Export specific session
dojops chat export --format=json         # Export as JSON
dojops chat export --output=chat.md      # Save to file