4 ms·
Show HN: HarnessRouter: Unified interface for agent harnesses
Hey HN! We are building HarnessRouter, a canonical API for running Codex, Claude Code, Hermes, and other managed agent harnesses as your product backend.
Before building HarnessRouter, I used to build our own agent harness for our products. I tried LangGraph, agent SDKs from different vendors, pydantic, LLM tool use / function call, and so on. It's a very heavy lifting engineering effort, and I am disappointed about the agent deliveries compared to what Codex, CC can deliver. That changed my mindset. The frontier labs and famous open source communities are already putting so much engineering effort to build the world's best harnesses, why not leverage them directly instead of building our own, just like how we call LLM chat completion endpoints instead of training our own models?
We provide a docker image to run HarnessRouter locally.
----------
Quickstart:
docker pull harnessrouter/harnessrouter
docker run -d --name harnessrouter -p 127.0.0.1:3000:3000 -v harnessrouter:/data harnessrouter/harnessrouter
docker logs -f harnessrouter
Wait for the "ready on :3000" show up, then open the browser at http://localhost:3000.
Default username/password is harnessrouter/harnessrouter
Then in Integrations page, add your model provider credentials or API keys.
In Harnesses tab, as of today we provide routing to Codex, Claude Code, and Hermes as base harnesses.
You can customize any of them and configure harness instruction, MCP tools, and skills.
Then go to Tasks and let them do jobs.
----------
Every harness has its own request/response format and incompatible with each other. We propose Unified Harness Procotol [1] to standardize how an application talks to an agent harness. It covers harness selection and configuration, task execution, event streaming, sessions start cancel and resume, artifact management and delivery, and failure handling. It's similar idea like LiteLLM, but for harnesses rather than models.
HarnessRouter implements UHP. We provide an AGENTS.md [2] and your coding agent can follow it to integrate your application with the harnesses available.
We also provide starter kits [3] to demonstrate some types of agentic products that can be built on HarnessRouter. It currently includes PPT agent, Spreadsheet agent, BI Dashboard agent, and Video generation agent.
Can't wait to hear what you think!
[1] https://unifiedharnessprotocol.org https://unifiedharnessprotocol.org
[2] https://harnessrouter.ai/agents.md https://harnessrouter.ai/agents.md
[3] https://github.com/harnessrouter/starter-kit https://github.com/harnessrouter/starter-kit
- kuanzema 2mo agoHere's Kuanze, co-founder of HarnessRouter. Before building HarnessRouter, I was building an entire harness to power other products. Building a harness was pretty fun for me. I enjoyed and learned quite a lot through building it. However, Richard asked me a question: how do you plan to keep up with the iteration speed of harnesses like Codex and Claude code. That question leads to the solution that we are delivering to the community today. From our perspective, the agent harness is becoming an independent infra layer, and it should become a dev tool. Our goal is to make agent harnesses plug-and-play solution for all developers, so they can skip rebuilding the infra layer and focus on shipping product features. We welcome all comments, feedbacks, protocol contributions, and feature suggestions.
- producthunter00 2mo ago[dead]
- Bnjoroge 2mo agoWhat’s the pitch for a harness router?iirc codex has codex app server, pi also has a reusable core.
- songrenchu 2mo agoThink of it as OpenRouter, but for different agent harnesses, not models. Instead of sticking to any one harness, you can route to and use any of them through a unified API
- kuanzema 2mo agoOn top of that, in HarnessRouter cloud: we provide developers with seamless deployment for their serveless, managed agents in sandboxes that can scale at anytime; and tracing insights so they can pick the best Harness × Model × Tools × Skills combination based on production performance. In one benchmark, one combination is 99.8% cheaper, and one combination is 3.2× faster. Check out the benchmark here: https://harnessrouter.ai/benchmarks https://harnessrouter.ai/benchmarks
- 2mo ago