harness

A fast, extensible, composable agent harness in Go.

• Fast — millisecond startup, CI-enforced budgets
• Extensible — language-agnostic process plugins with a Go SDK
• Composable — headless engine, event streams, client/server, MCP both directions
• Model-fluid — swap providers/models mid-session or per-subagent with no migration

See AGENTS.md for architecture and design decisions.

Configuration

Config lives at ~/.harness/config.json (override with $HARNESS_CONFIG), optionally overlaid by a per-project .harness.json. It's a flat JSON file; see config.Config for the full field list. Model refs are provider/model, and provider is either a built-in family (anthropic, openai) or a name from providers.

Any OpenAI-compatible chat-completions endpoint — OpenRouter, Ollama, vLLM, LM Studio, and the like — is a two-line providers entry, no code required:

{
  "providers": {
    "ollama": {
      "type": "openai-compat",
      "base_url": "http://localhost:11434/v1",
      "api_key_env": "OLLAMA_API_KEY"
    }
  }
}

The map key becomes the provider name for model refs, e.g. "model": "ollama/llama3.1". Optional fields: family (the wire-quirk / ProviderData tag, defaults to the map key) and extra_headers (sent verbatim on every request, e.g. OpenRouter's attribution headers):

{
  "providers": {
    "openrouter": {
      "type": "openai-compat",
      "base_url": "https://openrouter.ai/api/v1",
      "api_key_env": "OPENROUTER_API_KEY",
      "extra_headers": {"HTTP-Referer": "https://example.com", "X-Title": "my-app"}
    }
  }
}

OpenRouter itself needs no config at all: if providers has no openrouter entry, harness registers one automatically with the base URL and api_key_env above, so "model": "openrouter/anthropic/claude-sonnet-5" works as soon as OPENROUTER_API_KEY is set. Any openrouter entry in config — even a partial one — overrides the built-in default entirely.

An unrecognized type, or an openai-compat entry missing base_url, fails config loading loudly rather than silently registering nothing.