Skip to main content

​
Usage

archal config <subcommand> [options]

​
Subcommands

​
config show

Print the current resolved configuration. 
archal config show
archal config show --json

​
config set <key> <value>

Set a configuration value. 
archal config set defaults.runs 10
archal config set defaults.timeout 180
archal config set telemetry false
archal config set evaluator.model gemini-2.5-flash
archal config set evaluator.apiKey env:GEMINI_API_KEY
archal config set evaluator.baseUrl https://my-proxy.example.com/v1
archal config set engine.defaultHarness react
Available keys:
KeyDescriptionType
telemetryEnable or disable telemetryboolean
evaluator.modelModel for probabilistic criteria evaluationstring
evaluator.apiKeyEvaluator API key (supports env:VAR_NAME)string
evaluator.baseUrlCustom base URL for evaluator LLM callsstring
defaults.runsDefault number of runs per scenarionumber
defaults.timeoutDefault timeout in secondsnumber
engine.defaultHarnessDefault named harness when --harness is omittedstring

​
config init

Create a default config file at ~/.archal/config.json. 
archal config init
archal config init --force

​
config path

Print the config file path. 
archal config path

​
Config file format

Default file (archal config init): 
{
  "telemetry": false,
  "evaluator": {
    "model": "gemini-2.5-flash",
    "apiKey": "env:GEMINI_API_KEY"
  },
  "defaults": {
    "runs": 1,
    "timeout": 180
  },
  "engine": {}
}
evaluator.apiKey supports:
  • env:GEMINI_API_KEY (recommended)
  • A literal key value (supported but not recommended)

​
Environment variable overrides

These override the config file at runtime:
VariableOverrides
ARCHAL_TELEMETRYtelemetry
ARCHAL_MODELevaluator.model
ARCHAL_EVALUATOR_BASE_URLevaluator.baseUrl
ARCHAL_RUNSdefaults.runs
ARCHAL_TIMEOUTdefaults.timeout
ARCHAL_DEFAULT_HARNESSengine.defaultHarness
ARCHAL_HOMEConfig directory location (~/.archal by default)

​
Authentication note

CLI auth is separate from this config file. Use:
  • archal login (recommended)
  • ARCHAL_TOKEN in CI/non-interactive environments

​
Removed keys from older versions

These keys are no longer supported and should be removed if present:
  • engine.apiKey
  • evaluator.provider
  • seedGeneration.*
The CLI prints warnings when it sees them.