Docs navigation

Harnesses

A harness is a concrete agent runtime with its own on-disk configuration layout. Each harness gets one adapter that implements pack (layout → canonical bundle) and unpack (bundle → layout).

Capability levels

Adapters declare, per component type, exactly how faithfully they can represent it — and the conformance suite holds them to it:

  • Native — the harness has a first-class home for the component and the adapter round-trips it losslessly (digest-verified).
  • Emulated — no exact home; the adapter installs a faithful approximation and says so in the fidelity report.
  • Planned — on the adapter roadmap; today the component is reported as skipped, never silently dropped.

Support matrix

UAP component support across harnesses: native, emulated, or planned
ComponentClaude CodeCodexOpenCodeCursorFactoryDevin CLI
Instructions
Commands
Subagents
Skills
MCP servers
Hooks
Permissions
Setup
Env
Files
Native — first-class home, lossless round-tripEmulated — faithful approximation, honestly reportedPlanned — on the adapter roadmap

The harnesses

Reading a conversion

Every pack/unpack prints a fidelity report — one line per component. A conversion is lossy iff anything was emulated or skipped, and the report tells you exactly what and why:

  ✅ instructions/core
  ◐  instructions/frontend-rules  (activation "auto" folded into AGENTS.md)
  —  commands/triage              (commands not supported by this adapter yet)

  unpack was LOSSY — see entries above.