Configuration
The primary config file is harness.config.json.
Important current rules
models[]is the primary shape- legacy
workerconfig still works during the soft-stable cycle - routing, semantic, and distributed settings should evolve additively
Core sections
| Section | Purpose |
|---|---|
models | model registry with providers, tags, tiers, and endpoints |
worker | legacy fallback worker settings |
execution | fixture root, worktree base, log directory, max attempts override |
profiles | named execution profiles such as local, distributed, and semantic |
distributed | controller or worker runtime settings |
contextEngine | retrieval-aware context assembly controls |
semantic | embedding and indexing options |
policy | allowed paths, commands, blocked patterns, and secret scan behavior |
First-run guidance
Do not hand-author your first config from scratch.
Start with:
harness init --profile local
Then adapt it.