CLI Configuration

The Arctic CLI stores connection details in a configuration file.

File Location

Default: ~/.config/arctic/config.yaml

Override with the --config flag or ARCTIC_CONFIG environment variable.

Configuration Format

Groups peers by cluster with shared credentials and global preferences:

current_cluster: 01HABCDEF456...

clusters:
  01HABCDEF456...:
    cluster_id: 01HABCDEF456...
    customer_id: cust_xyz789...
    client_id: cl_01HXYZ...
    client_secret: sec_abc123...
    peers:
      - url: http://192.168.1.10:8080
        peer_id: 01HXYZABC123...
        name: Agent A
      - url: http://192.168.1.20:8080
        peer_id: 01HXYZDEF789...
        name: Agent B
    default_peer: 01HXYZABC123...
    name: Production

preferences:
  cache_ttl: 3600      # Cache TTL in seconds (default: 3600)
  auto_failover: false # Reserved for future use

Cluster Object

Peer Object

Preferences

Global CLI preferences that apply to all commands:

Preference Details:

• output_format: Sets the default output format for all commands. Can be overridden with --output flag.
• color: Controls whether CLI output uses ANSI colors. Automatically disabled when NO_COLOR environment variable is set.
• timeout: Default HTTP request timeout for API calls. Can be overridden with --timeout flag.
• cache_ttl: Time-to-live for the completion cache in seconds. Cache is considered stale after this duration. See Completion Cache for details.
• auto_failover: Reserved for future peer failover feature. Currently not implemented.

Managing Configuration

View Current Context

arctic config current

Switch Context

arctic config use-cluster Production

List All Contexts

arctic config list

View Full Config

arctic config view

Security Considerations

The config file contains credentials. Protect it:

chmod 600 ~/.config/arctic/config.yaml

Consider using environment variables for CI/CD:

export ARCTIC_URL="http://agent:8080"
export ARCTIC_TOKEN="eyJ..."
arctic peers list

See Also

• config CLI Command
• Environment Variables