Configuration

The CLI uses a layered configuration system with multiple sources. Higher priority sources override lower ones.

Configuration Priority

Run the configuration wizard to set up credentials interactively:

vsb config

This prompts for your API key and gateway URL, then saves them to the config file.

# Set API key
vsb config set api-key "your-api-key"

# Set gateway URL
vsb config set base-url "https://your-gateway.vsx.email"

vsb config show

The API key is masked in the output for security.

The config file is stored at ~/.config/vsb/config.yaml:

api_key: your-api-key
base_url: https://your-gateway.vsx.email
default_output: pretty

Note: default_output can only be set by editing the config file directly. The vsb config set command only supports api-key and base-url.

Example:

export VSB_API_KEY="your-api-key"
export VSB_BASE_URL="https://your-gateway.vsx.email"
vsb inbox create

These flags work with any command:

Flag	Description
`--config`	Specify config file path
`-o, --output`	Output format: `pretty` or `json`

Example:

vsb inbox list --output json

The CLI stores data in ~/.config/vsb/:

File	Description
`config.yaml`	Configuration settings
`keystore.json`	Inbox private keys (base64-encoded)