Configuration Reference¶
Workspace defaults¶
Stored under .ai-workspace/config.json when changed.
| Key | Default | Description |
|---|---|---|
output | json | Structured CLI output format. |
logRetentionDays | 30 | Local redacted event retention. |
confirmApply | true | Require confirmation policy for applicable changes. |
ai-workspace config
ai-workspace config logRetentionDays 14 --dry-run
ai-workspace config logRetentionDays 14 --apply
ai-workspace config export --output safe-config.json --apply
ai-workspace config import --input safe-config.json --dry-run
Configuration scopes¶
- Workspace: registry, config, managed assets, providers, logs.
- Project: generated non-secret
.ai/,configs/, provider selection. - Provider: model, temperature, max output, timeout, retries, priority, limits.
- Plugin/MCP: declarative registries; disabled until explicitly activated.
- Environment: credentials and endpoints that must not be committed.
Safe exports exclude credential values and runtime payloads. Unknown configuration keys fail validation.
See Environment variables and schemas.