Skip to content

devo config

Manage Devo CLI configuration settings.

Overview

The config command allows you to view, modify, and manage your Devo CLI configuration. Configuration is stored in ~/.devo/config.json and includes settings for Bedrock, GitHub, CodeArtifact, SSM, DynamoDB, and version checking.

Subcommands

show

Display configuration settings.

# Show all configuration
devo config show

# Show specific section
devo config show --section ssm
devo config show -s dynamodb

# Show as JSON
devo config show --json

sections

List all available configuration sections.

devo config sections

set

Set a configuration value using dot notation.

devo config set <key> <value>

Examples:

devo config set bedrock.model_id us.anthropic.claude-sonnet-4-20250514-v1:0
devo config set version_check.enabled false

path

Show the path to the configuration file.

devo config path

reset

Reset configuration to default values.

devo config reset [OPTIONS]

Options:

  • -s, --section TEXT - Reset only specific section
  • --yes - Confirm the action without prompting

Examples:

# Reset all configuration (with confirmation)
devo config reset

# Reset without confirmation
devo config reset --yes

# Reset only SSM section
devo config reset -s ssm

# Reset SSM section without confirmation
devo config reset -s ssm --yes

Warning: This will delete your current configuration and restore defaults.

export

Export configuration to a file or stdout.

# Export to default timestamped file
devo config export

# Export to stdout
devo config export --stdout

# Export to custom file
devo config export -o backup.json
devo config export --output ~/backups/config.json

# Export specific sections
devo config export -s ssm
devo config export --section ssm --section dynamodb -o partial.json

# Export specific sections to stdout
devo config export -s ssm -s dynamodb --stdout

Options:

  • -o, --output FILE - Output file path (default: timestamped file)
  • -s, --section TEXT - Export only specific section(s) (can be used multiple times)
  • --stdout - Output to stdout instead of file

import

Import configuration from a file.

devo config import <filename> [OPTIONS]

Options:

  • -s, --section TEXT - Import only specific section(s)
  • --replace - Replace section completely instead of merging (default: merge)

Examples:

# Import full config (merges with existing)
devo config import backup.json

# Import only SSM section
devo config import backup.json -s ssm

# Replace SSM section completely (instead of merging)
devo config import backup.json -s ssm --replace

# Import multiple sections
devo config import backup.json -s ssm -s dynamodb

migrate

Migrate legacy configuration files to consolidated format.

devo config migrate [OPTIONS]

Options:

  • --no-backup - Don't backup legacy files

This migrates:

  • ~/.devo/ssm-config.json → ssm section
  • ~/.devo/dynamodb/export_templates.json → dynamodb section

Examples:

# Migrate with backup (default)
devo config migrate

# Migrate without backup
devo config migrate --no-backup

Configuration Sections

Bedrock Settings

  • bedrock.model_id - Primary Bedrock model ID
  • bedrock.fallback_model_id - Fallback model ID

GitHub Settings

  • github.repo_owner - Repository owner/organization
  • github.repo_name - Repository name

CodeArtifact Settings

  • codeartifact.region - CodeArtifact region
  • codeartifact.account_id - Account ID
  • codeartifact.sso_url - SSO URL
  • codeartifact.required_role - Required role
  • codeartifact.domains - List of domain configurations

SSM Settings

  • ssm.databases - Database connection configurations
  • ssm.instances - EC2 instance configurations

DynamoDB Settings

  • dynamodb.export_templates - Saved export filter templates

Version Check Settings

  • version_check.enabled - Enable automatic version checks (default: true)

Configuration File Format

The configuration file is JSON format located at ~/.devo/config.json:

{
  "bedrock": {
    "model_id": "us.anthropic.claude-3-7-sonnet-20250219-v1:0",
    "fallback_model_id": "us.anthropic.claude-3-7-sonnet-20250219-v1:0"
  },
  "github": {
    "repo_owner": "edu526",
    "repo_name": "devo-cli"
  },
  "codeartifact": {
    "region": "us-east-1",
    "account_id": "123456789012",
    "sso_url": "https://my-org.awsapps.com/start",
    "required_role": "Developer",
    "domains": [
      {
        "domain": "my-domain",
        "repository": "npm",
        "namespace": "@myorg"
      }
    ]
  },
  "ssm": {
    "databases": {
      "my-db": {
        "host": "localhost",
        "port": 5432,
        "instance_id": "i-1234567890abcdef0",
        "remote_port": 5432,
        "profile": "production"
      }
    },
    "instances": {
      "my-instance": {
        "instance_id": "i-1234567890abcdef0",
        "profile": "production"
      }
    }
  },
  "dynamodb": {
    "export_templates": {
      "users-active": {
        "table_name": "users",
        "filter_expression": "attribute_exists(#status) AND #status = :active",
        "expression_attribute_names": {
          "#status": "status"
        },
        "expression_attribute_values": {
          ":active": "active"
        }
      }
    }
  },
  "version_check": {
    "enabled": true
  }
}

Environment Variables

Environment variables override configuration file values:

  • AWS_REGION
  • AWS_ACCOUNT_ID
  • AWS_SSO_URL
  • AWS_REQUIRED_ROLE
  • BEDROCK_MODEL_ID
  • GITHUB_REPO_OWNER
  • GITHUB_REPO_NAME
  • DEVO_SKIP_VERSION_CHECK

Troubleshooting

Configuration Not Loading

# Check file exists
devo config path

# View current config
devo config show

# Reset if corrupted
devo config reset

Migrating from Old Config Files

If you have legacy configuration files:

# Migrate automatically
devo config migrate

# Verify migration
devo config show -s ssm
devo config show -s dynamodb

Invalid Values

# View specific section
devo config show --section bedrock

# Reset to defaults
devo config reset

See Also