CLI: Configuration

The Keito CLI can be configured via environment variables, a config file, or command-line flags.

Precedence

Configuration is resolved in this order (highest priority first):

1. Command-line flags (e.g., --project acme)
2. Environment variables (e.g., KEITO_PROJECT)
3. Config file (~/.keito/config.toml)
4. Defaults

Environment Variables

Variable	Description
KEITO_API_KEY	API key for authentication
KEITO_ACCOUNT_ID	Your workspace/account ID
KEITO_PROJECT	Default project slug
KEITO_TASK	Default task slug
KEITO_SOURCE	Default source value

Config File

The CLI reads from ~/.keito/config.toml:

[auth]
api_key = "keito_sk_abc123..."
account_id = "acc_xyz789"

[defaults]
project = "acme"
task = "development"
source = "cli"

[agent]
agent_id = "review-bot-01"

Create the config file:

keito config init

Project-Level Config

Place a .keito.toml file in your project root to set per-project defaults:

[defaults]
project = "acme-website"
task = "development"

This is useful for monorepos or teams where each repository maps to a specific Keito project.

Setting Defaults

# Set default project
keito config set defaults.project acme

# Set default task
keito config set defaults.task development

# View current config
keito config list