Skip to content
UHPUHPDeveloper Guide
Independent developer guide. Not affiliated with HarnessRouter or the official UHP project.

Unified Harness Protocol, explained for builders

Build one client for complete agent runtimes. Understand the execution contract, choose an integration and check the evidence behind each capability.

Page reviewed 4 Oct 2026 Source and review policy

Start with your task

Section titled “Start with your task”

Learn the boundary

Understand what UHP standardizes and which responsibilities stay inside the agent runtime.

Understand UHP

Build an integration

Discover capabilities, negotiate a version and follow a task through its final result.

Run your first task

Compare interfaces

Choose between harness execution, tool connectivity and interactive client interfaces.

Choose a boundary

One execution boundary, distinct responsibilities

Section titled “One execution boundary, distinct responsibilities”
  1. ClientRequest + results
  2. UHP serverContract + authority
  3. HarnessLoop + session state
  4. Tools + modelActions + inference
Your client submits work to a UHP server. The complete harness owns its loop, tools and model calls.

A configured harness owns the agent loop. Your client uses the UHP contract to request work, observe results and continue a session. An adapter behind the server does not establish native upstream adoption.

Choose your integration

Start at the boundary you need to control. These interfaces can compose in one system.

Start with UHP. Discover the server's capabilities, choose a configured harness and track tasks and continuation. Build the smallest UHP workflow. Tools inside the harness may still use MCP.

Start with MCP. Connect the application to tools, resources and prompts. It does not replace complete-harness execution. Compare the two boundaries.

Evaluate Agent Client Protocol. Use the editor-to-agent interface when the client needs interactive coding sessions and permission exchange. Check ACP's scope and composition.

Evaluate A2A. Exchange work with an agent service, then decide whether it uses UHP internally to drive a harness. Compare delegation and execution.

Practical guides and comparisons

Section titled “Practical guides and comparisons”

Choose a Codex interface

Compare CLI, app server and the HarnessRouter adapter before building.

Read the guide

Understand Qwen Live

Separate realtime ownership, background backends and desktop prerequisites.

Read the guide

Instrument with NeMo Relay

Follow execution scopes, middleware and events without confusing them with UHP.

Read the guide

Recover interrupted work

Use durable state and terminal evidence to decide whether a task can continue safely.

Read the guide

Explore the guide

Section titled “Explore the guide”

Seven subjects; every guide has one primary home.

Harnesses & Platforms

Choose an execution gateway, coding harness, SDK or runtime service.

31 guides · browse this subject

Execution gateways

Coding assistants

Agent runtimes

Frameworks and SDKs

Runtime services & tooling

Protocols & Standards

Compare interfaces by their boundary, maturity and authority.

34 guides · browse this subject

Tools and extensions

Client and UI interfaces

Agent exchange and discovery

Identity and control

Events, trajectories and assets

Engineering Guides

Design orchestration, recovery and execution integrity.

18 guides · browse this subject

Orchestration and execution

State and recovery

Trust and execution integrity

Current state: 4 October 2026

Section titled “Current state: 4 October 2026”
Protocol2026-09-28Draft; optional Environments
Reference implementationv0.29.1Stable release; development main is separate
Conformance source85 checksPackage 2026.9.28.post3; source count, not a server result

The released backend set remains at 20. v0.29.0 added four backend families; current stable v0.29.1 fixes relay streaming and upstream-liveness behavior without changing UHP or conformance. Read the release tracker for the exact version history, and the Environments guide before selecting reusable project state. The task override is metadata.environment; the specification’s drift note explains the conflicting upstream table.

Primary sources

Section titled “Primary sources”

The versioned UHP source, stable HarnessRouter release and conformance package underpin the status above. This independent publication’s source policy explains how current guidance and historical results are kept distinct.