CloudOps Tools

config

Manage persistent configuration settings for CloudOps Tools.

Usage

cloudops-tools config [subcommand] [options]

Subcommands

SubcommandDescription
setSet a configuration value
getGet configuration value(s)
unsetRemove a configuration value
pathShow the configuration file path

Configuration Keys

KeyTypeDescription
defaultRegionstringDefault AWS region for scans
defaultAccountstringDefault AWS account or profile
defaultFormatstringDefault export format (csv, xlsx, json)
defaultModestringDefault scan mode (basic, detailed, security, cost)
defaultServicesstring[]Default services to scan
skipGlobalbooleanSkip global services by default
onlyGlobalbooleanScan only global services by default

config set

Set a configuration value.

Usage

cloudops-tools config set <key> <value>

Examples

# Set default region
cloudops-tools config set defaultRegion eu-west-1

# Set default export format
cloudops-tools config set defaultFormat xlsx

# Set default scan mode
cloudops-tools config set defaultMode security

# Set default services (comma-separated)
cloudops-tools config set defaultServices EC2,RDS,Lambda

# Enable skip global by default
cloudops-tools config set skipGlobal true

# Set default account/profile
cloudops-tools config set defaultAccount production

config get

Get one or all configuration values.

Usage

# Get all configuration
cloudops-tools config get

# Get a specific key
cloudops-tools config get <key>

Examples

# Show all configuration
cloudops-tools config get

# Get specific value
cloudops-tools config get defaultRegion
cloudops-tools config get defaultFormat

config unset

Remove a configuration value.

Usage

cloudops-tools config unset <key>

Examples

# Remove default region setting
cloudops-tools config unset defaultRegion

# Remove default services
cloudops-tools config unset defaultServices

config path

Show the path to the configuration file.

Usage

cloudops-tools config path

Example

cloudops-tools config path
# Output: /Users/username/.config/cloudops-tools/config.json

Configuration File

Configuration is stored as JSON. Example configuration:

{
  "defaultRegion": "eu-west-1",
  "defaultFormat": "xlsx",
  "defaultMode": "security",
  "defaultServices": ["EC2", "RDS", "Lambda", "S3"],
  "skipGlobal": false,
  "onlyGlobal": false
}

Precedence

Command-line options always take precedence over configuration file settings. This allows you to set sensible defaults while overriding them when needed:

# Uses config file defaults
cloudops-tools init

# Overrides defaultFormat from config
cloudops-tools init --export-format json