Global Flags

These flags can be used with any Arctic CLI command.

Context Selection

--context, -c

Specify a context (peer or cluster) to use for this command.

arctic peers list --context my-cluster
arctic peers list -c prod-agent-01

Accepts peer ID, peer name, cluster ID, or cluster name.

Connection Override

--url

Override the agent URL for this command.

arctic health --url http://192.168.1.10:8080

--token

Use a specific access token instead of the configured credentials.

arctic peers list --token "eyJ..."

--client-id

Override the OAuth client ID.

arctic peers list --client-id "cl_01HXYZ..."

--client-secret

Override the OAuth client secret.

arctic peers list --client-secret "sec_..."

--insecure

Skip TLS certificate validation.

arctic health --url https://agent.example.com --insecure

Warning: Only use for testing. Do not use in production.

Output Control

--output, -o

Set the output format. Options: table, json, yaml.

# Table format (default)
arctic peers list

# JSON format
arctic peers list -o json

# YAML format
arctic peers list -o yaml

--json, -j

Output in JSON format. This is a shorthand for -o json.

# These are equivalent
arctic peers list -j
arctic peers list -o json

For list commands, table format shows compact tables with essential information. Use -j or -o json for full detailed output including all fields.

--no-headers

Omit column headers in table output.

arctic peers list --no-headers

Useful for scripting.

--quiet, -q

Suppress non-error output.

arctic services delete SERVICE_ID --yes --quiet

Confirmation

--yes, -y

Skip confirmation prompts for destructive operations.

arctic peers delete PEER_ID --yes
arctic services delete SERVICE_ID -y

Debugging

--debug

Show debug information including operation progress and internal state.

arctic peers list --debug

Output includes [debug] prefixed messages showing each step of the operation.

--trace

Show full HTTP request and response traces.

arctic peers list --trace

Includes headers and bodies.

Timeout

--timeout

Set request timeout. Accepts duration format (e.g., 30s, 1m30s).

arctic peers add 192.168.1.20:8080 --timeout 60s

Default: 30s

Configuration

--config

Path to configuration file.

arctic peers list --config /path/to/config.yaml

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

Flag Combinations

Flags can be combined as needed:

# Debug with JSON output
arctic peers list --debug -j

# Context with timeout
arctic health --context my-agent --timeout 10s

# Override URL with trace
arctic peers list --url http://localhost:8080 --trace

Environment Variables

Some flags have equivalent environment variables: