Configuration

Config File

The CLI stores configuration in a JSON file at:


~/.expunct/config.json

Format


{
  "api_key": "your_api_key",
  "base_url": "https://api.expunct.ai",
  "tenant_id": "your-tenant-id"
}

Field	Description
`api_key`	Your API key (starts with `pk_live_` or `pk_test_`)
`base_url`	API base URL (default: `https://api.expunct.ai`)
`tenant_id`	Tenant ID for multi-tenant setups

Environment Variables

You can override any config file value with an environment variable:

Variable	Description
`EXPUNCT_API_KEY`	API key (overrides `api_key` in config file)
`EXPUNCT_BASE_URL`	API base URL (overrides `base_url` in config file)
`EXPUNCT_TENANT_ID`	Tenant ID (overrides `tenant_id` in config file)


export EXPUNCT_API_KEY=pk_live_...
export EXPUNCT_BASE_URL=https://api.expunct.ai
export EXPUNCT_TENANT_ID=your-tenant-id

Priority Order

Configuration values are resolved in the following order (highest priority first):

Environment variables — always take precedence
Config file — ~/.expunct/config.json

Config Management Commands


# Set a value
expunct config set api_key YOUR_API_KEY
 
# Get a value
expunct config get base_url
 
# Show all values
expunct config show
 
# Print config file path
expunct config path

See Commands for the full config command reference.