Ultimate Harness

Runtime targets

How Ultimate Harness adapters translate a portable mission packet into each agent runtime's command or HTTP call.

Ultimate Harness is runtime-agnostic: mission packets and verification artifacts stay stable while adapters translate a mission into each agent runtime's command or HTTP call.

RuntimeAdapter IDInvocation shapeNotes
Hermes AgenthermesLocal CLIReference adapter.
Codex CLIcodexcodex execUses workspace-write sandboxing and JSON output.
Hermes Proxyhermes-proxyLocal HTTP endpointSubscription-backed OAuth route through Hermes Proxy.
OpenRouteropenrouterOpenAI-compatible HTTPRequires OPENROUTER_API_KEY.
Pi CLIpiLocal CLIBase Pi command surface.
oh-my-pioh-my-piLocal CLIOpt-in OMP route with documented posture.
AnthropicanthropicAnthropic Messages HTTPNative pay-per-token path. Requires ANTHROPIC_API_KEY. Experimental (shipped v0.9.0).

Adapter contracts

All adapters should:

  • Render the same mission packet into a runtime prompt.
  • Write runtime-session.yaml, events.ndjson, runtime-result.yaml, runtime-final.txt, and diff.patch.
  • Respect sandbox routing unless explicitly bypassed.
  • Redact or avoid secrets in persisted artifacts.
  • Support dry-run where possible so CI and reviewers can inspect command shape safely.

See Runtime adapter contract for the detailed protocol.

API-key adapters

Adapters that need an API key (openrouter, anthropic) degrade gracefully when it's missing: uh adapter check <id> reports the missing key instead of crashing, and mission run fails fast with a plan error. Keys are read from the environment and never stored in the manifest.

See also

On this page