usage.md

Usage

Connect to an instance

# Connect to an instance by name
ssm my-instance-name
# The CLI searches across configured profiles and regions

List instances

ssm list            # Default view (SSM-managed Online)
ssm list --all      # Show all instances
ssm list --region us-east-1
ssm list --profile myprofile
ssm list --profile dev --region us-west-2

Sync instances

ssm sync                  # Sync all instances (enabled regions)
ssm sync --profile prod   # Sync for a specific profile
ssm sync --region eu-west-1

Update regions

ssm update-regions        # Interactive region enable/disable

Global options

ssm --verbose list
ssm --profile myprofile list
ssm --region us-east-1 list
ssm --config /path/to/config.yaml list

Examples

Basic workflow

ssm sync
ssm list
ssm my-web-server

Multiple accounts

ssm sync
ssm list --profile production
ssm list --profile staging
ssm prod-web-01
ssm staging-db-01