Skip to main content

Configuration

The primary config file is harness.config.json.

Important current rules

  • models[] is the primary shape
  • legacy worker config still works during the soft-stable cycle
  • routing, semantic, and distributed settings should evolve additively

Core sections

SectionPurpose
modelsmodel registry with providers, tags, tiers, and endpoints
workerlegacy fallback worker settings
executionfixture root, worktree base, log directory, max attempts override
profilesnamed execution profiles such as local, distributed, and semantic
distributedcontroller or worker runtime settings
routingmodel-selection ladder, fallback policy, scores, and domain defaults
contextEngineretrieval-aware context assembly controls
semanticembedding and indexing options
policyallowed paths, commands, blocked patterns, and secret scan behavior
agentBrainoptional Brain MCP/REST endpoints for recall and memory integration

First-run guidance

Do not hand-author your first config from scratch.

Start with:

npm run harness -- init --profile local

Then adapt it.