ai-agent

harnessrouter

Name: harnessrouter
Author: 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.

3,206 stars352 forksPythonUpdated 10/22/2026100% free · open source

About this skill

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.

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/79596c41-2900-4495-8641-fb2e00f7f65a && curl -fsSL https://workflowstacks.com/api/skills/79596c41-2900-4495-8641-fb2e00f7f65a/claude-skill -o ~/.claude/skills/79596c41-2900-4495-8641-fb2e00f7f65a/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How harnessrouter works

Codeflow

Free to inspect

Harnessrouter is a very large Python project (~60k lines across 177 code files, plus 233 test files). It is a full software project: use it through its install path rather than reading it end to end. Last commit this month, Apache-2.0 license, has a test suite.

Size

Very large codebase

~60k lines · 177 code files · ~8 h to skim

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

Docker

Needs API keys (.env)

Python 76%TypeScript 12%CSS 8%JavaScript 2%Shell 2%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
gateway/app.py
Where the program starts running
3
.env.example
The API keys and settings you must provide

What's in each folder

ui/Frontend / UI194 files

docs/Documentation35 files

gateway/Folder143 files

protocol/Folder141 files

runner/Folder122 files

scripts/Helper scripts32 files

docker/Deployment / infrastructure5 files

.github/CI / automation (GitHub Actions)10 files

READMEHas testsDocumentedCI checksDocker readyApache-2.0 licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/79596c41-2900-4495-8641-fb2e00f7f65a && curl -fsSL https://workflowstacks.com/api/skills/79596c41-2900-4495-8641-fb2e00f7f65a/claude-skill -o ~/.claude/skills/79596c41-2900-4495-8641-fb2e00f7f65a/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

HarnessRouter

Language

Python