Client Configuration

coldrune.yml

Create a coldrune.yml in your project directory to set defaults for CLI commands:

server_url: http://localhost:7100
org: my-org
project: api-backend
env: dev

With this file, you can omit repeated flags:

# Instead of:
coldrune secret get DB_PASSWORD --org my-org --project api-backend --env dev

# Just:
coldrune secret get DB_PASSWORD

Resolution order

Each parameter is resolved in this order (first match wins):

1. CLI flag (--org, --project, --env)
2. Environment variable (COLDRUNE_ORG, COLDRUNE_PROJECT, COLDRUNE_ENV)
3. coldrune.yml in the current directory
4. Error (parameter required)

Environment variables

Variable	Purpose
COLDRUNE_SERVER_URL	Server URL (default: http://localhost:7100)
COLDRUNE_API_KEY	Service account API key (overrides session token)
COLDRUNE_ORG	Default organization
COLDRUNE_PROJECT	Default project
COLDRUNE_ENV	Default environment

Server URL

The --server-url flag (or COLDRUNE_SERVER_URL) sets the server address for all CLI client commands:

coldrune --server-url https://api.coldrune.com secret list

Or in coldrune.yml:

server_url: https://api.coldrune.com

For server-side configuration (environment variables for coldrune server start), see Self-Hosting / Configuration.