Configuration
Configuring the Kubiya CLI using environment variables.
Configuration
The Kubiya CLI can be configured using environment variables to customize its behavior to suit your workflow.
Environment Variables
Environment variables are the primary way to configure the Kubiya CLI.
Available Environment Variables
Variable | Description | Default |
---|---|---|
KUBIYA_API_KEY | Your Kubiya API token | - |
KUBIYA_API_URL | The Kubiya API endpoint | https://api.kubiya.ai/v1 |
KUBIYA_OUTPUT | Default output format (json , yaml , table ) | table |
KUBIYA_DEFAULT_TEAMMATE | Default teammate name for chat commands | - |
KUBIYA_TIMEOUT | Global timeout for API requests (seconds) | 60 |
KUBIYA_LOG_LEVEL | Logging level (debug , info , warn , error ) | info |
KUBIYA_NO_COLOR | Disable colored output if set to any value | - |
Configuration Precedence
The CLI resolves configuration in the following order (highest precedence first):
- Command-line flags (e.g.,
--output json
) - Environment variables (e.g.,
KUBIYA_OUTPUT=json
) - Default values
Working with Multiple Environments
Create environment-specific scripts
You can create shell scripts for different environments:
Switch between environments
Use environment variables for a single command
Never commit your scripts with API tokens to version control. Use a secure secrets manager for sensitive values in shared environments.