Harness docs / Reference

Environment variables

Variable Meaning
ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY API keys. Auto-detect uses them when no local server answers; a profile names the one it needs with apiKeyEnv.
HARNESS_HOME Where data/ lives (login token, memory, people notes, spend.json). Default ./data.
HARNESS_LOCAL_FILE Use this file instead of settings.local.json.
HARNESS_PERSONALITY_FILE Use this file instead of personality.md.
HARNESS_SERVER_URL Overrides serverUrl.
HARNESS_MODEL Overrides model.
HARNESS_LOCAL_HOST Extra hosts to look for a model server on, comma separated (a server on another machine).
HARNESS_DEBUG=1 Print the model's raw replies.
NO_COLOR=1 No dimming or colour.
VISUAL, EDITOR The editor /personality edit opens.
HARNESS_RUN_DEADLINE, HARNESS_WAIT_POLL_MS, HARNESS_WAIT_MINUTE_MS Used by scripts/load.ts and the tests: a time (ms since 1970) the wait tool never waits past, and how often / how fast it polls.