harnessrouter

HarnessRouter Community Edition: the self-hosted, Apache-2.0 edition of the unified interface for agent harnesses. Run Codex, Claude Code, Hermes, PI, DSH, and

What is harnessrouter?

HarnessRouter Community Edition: the self-hosted, Apache-2.0 edition of the unified interface for agent harnesses. Run Codex, Claude Code, Hermes, PI, DSH, and more through one API, with sessions, streaming, files, cancellation, and failure handling. Implements the Unified Harness Protocol (UHP), an open standard. Your keys, your infrastructure.

Overview of harnessrouter

What it is

HarnessRouter Community Edition is the self-hosted, Apache-2.0 edition of the unified interface for agent harnesses. It implements the Unified Harness Protocol (UHP) and provides an OpenAI Responses-compatible API. It turns existing harnesses like Codex and Claude Code into pluggable agent backends, handling persistent sessions, streaming progress, files, artifacts, cancellation, and structured failures.

Key features

  • Unified API for multiple agent harnesses (Codex, Claude Code, Hermes, PI, DSH, and more)
  • Implements the Unified Harness Protocol (UHP), an open standard
  • OpenAI Responses-compatible API for easy integration
  • Persistent sessions with streaming progress, file attachments, and artifact retrieval
  • Task cancellation and structured failure handling
  • Self-hosted with your own provider keys and infrastructure
  • Switch between harness and model configurations to optimize cost and latency

Use cases

Build agent products without handling harness engineering. Use HarnessRouter as the infrastructure layer to run tasks, retrieve results, and switch harnesses through one API. Suitable for integrating agent backends into product backends, running automated tasks with custom or built-in harnesses, and managing multiple model providers through a single interface.

Getting started

Self-host Community Edition with your own provider keys. You need Docker, about 4 GB of disk, and a provider API key. No HarnessRouter account required.1. Start HarnessRouter:docker run -d --name harnessrouter -p 127.0.0.1:3000:3000 -v harnessrouter:/data harnessrouter/harnessrouter2. Wait for the first launch (check logs until ready on :3000).3. Open http://localhost:3000 and sign in with username harnessrouter, password harnessrouter (change default password in Profile).4. Connect a model provider via Bring Your Own Key in the sidebar.5. Run your first task in Agent harnesses.For custom harnesses, create and configure in the Console. For API integration, create an API key and call the OpenAI Responses-compatible endpoint.

License and pricing

Licensed under Apache-2.0. Open source, self-hosted Community Edition. No bundled model or trial key. No HarnessRouter account required for self-hosting.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/harnessrouterharnessrouter.svg)](https://yunodb.com/tools/harnessrouterharnessrouter?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/harnessrouterharnessrouter?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/harnessrouterharnessrouter.svg" alt="Featured on YunoDB" height="20"></a>