// devtools · HarnessRouter/harnessrouter

harnessrouter

harnessrouter é um projeto de ferramentas de desenvolvimento de código aberto de HarnessRouter (HarnessRouter/harnessrouter no GitHub). Tem 2.929 estrelas no GitHub e 299 forks, é publicado sob a licença Apache-2.0 e foi atualizado pela última vez no GitHub em 8 de outubro de 2026.

One API for every agent harness — run Codex, Claude Code and more through a single self-hosted interface

★ 2,9 mil estrelas⑂ 299 forksApache-2.0atualizado out 2026
▦ visual: o README deste projeto não inclui nenhuma captura incorporável,
então aqui vai um marcador. O guia abaixo está completo mesmo assim.
// dados do projeto

Dados do projeto

Estrelas no GitHub
2.929
Forks
299
Licença
Apache-2.0
Última atualização no GitHub
8 de outubro de 2026
Tipo de ficha
Guia de instalação completo
Site oficial
Official site
// como funciona

Como funciona

  1. Clarify your goal

    Decide which harnesses you want behind one API and which model providers you will connect with your own keys.

  2. Get HarnessRouter

    Pull and run the official Docker image with a persistent data volume.

  3. Install and configure

    Wait for first launch to install the enabled harness CLIs, sign in to the console, and add a model provider under Bring Your Own Key.

  4. Run your first task

    Submit a task through the console or the OpenAI Responses-compatible API and watch it stream, then try switching harnesses.

// recursos

Por que as pessoas gostam tanto

Unified Harness Protocol

Implements UHP, an open standard, so harnesses become plug-and-play agent backends behind one integration.

Many harnesses, one API

Run Codex, Claude Code, Hermes, PI, DSH and more, and switch harnesses per task to optimize cost and latency.

OpenAI Responses-compatible

Provides an OpenAI Responses-compatible API for product integration.

Sessions and streaming

Persistent sessions, streaming progress, files and artifacts are handled by the router.

Cancellation and failures

Built-in cancellation and structured failure handling across harnesses.

Self-hosted, your keys

Community Edition runs on your infrastructure with your own provider keys; data persists in a Docker volume.

Advertisement
// execute você mesmo

Execute você mesmo

  1. Clone the repo

    Clone HarnessRouter (the quickest run path is the Docker image in step 2).

    git clone https://github.com/HarnessRouter/harnessrouter.git
    cd harnessrouter
  2. Run with Docker

    Start the self-hosted Community Edition exactly as the README quickstart shows.

    docker run -d --name harnessrouter \
      -p 127.0.0.1:3000:3000 \
      -v harnessrouter:/data \
      harnessrouter/harnessrouter
  3. Open the console

    Wait for '[harnessrouter] ready on :3000' in the logs, then open http://localhost:3000 and sign in (default harnessrouter / harnessrouter).

    docker logs -f harnessrouter
// casos de uso

O que você pode criar

Readers working through the Dev Tools shelf also stop at Assistant, AI stack centered on an agent hypervisor. The Dev Tools shelf also holds openmed — Local-first healthcare AI: clinical NER and HIPAA PII de-identification that runs 100% on-device. Readers working through the Dev Tools shelf also stop at KiroCrew, a persistent, self-improving workspace where AI dev crews keep working after you close the tab.

Advertisement
// perguntas frequentes

Perguntas frequentes

Who maintains HarnessRouter?

HarnessRouter (the team behind harnessrouter.ai) maintains it; this repo is the open Community Edition of their unified harness interface.

Is it free?

The Community Edition is free and Apache-2.0 licensed, self-hosted on your infrastructure. Harness CLIs installed on first launch keep their own upstream licenses.

Does it need a paid API key?

Yes — you bring your own model provider keys (added in the console under Bring Your Own Key); model usage is billed by your provider. You do not need a HarnessRouter API key to run console tasks.

How does it compare to integrating each harness directly?

Direct integration means handling sessions, streaming, files and failures separately for every harness. HarnessRouter gives one API and lets you switch harnesses freely.

How do I get started?

Run the Docker command from the README, wait for the ready log line, open http://localhost:3000, add a provider key, and run a task.

// continue explorando

Ferramentas semelhantes

Ferramentas de desenvolvimento

mission-control

Self-hosted control plane for AI agents: dispatch tasks, review runs, track spend, and operate OpenClaw, Claude Code, Codex, and other runtimes.

★ 6,3 mil estrelasMIT
Ver o guia →
Ferramentas de desenvolvimento

git-iris

Self-hosted dev tools: an intelligent agent that understands your code and cra.

★ 41 estrelasApache-2.0
Ver o guia →
Ferramentas de desenvolvimento

avibe

A local-first Agent OS — drive Claude Code, Codex and OpenCode from your browser.

★ 606 estrelasMIT
Ver o guia →
Ferramentas de desenvolvimento

vibe-kanban

A kanban board for coding agents — plan tasks, run Claude Code or Codex in parallel, review diffs

★ 28,3 mil estrelasApache-2.0
Ver o guia →
Ferramentas de desenvolvimento

kicad-happy

AI coding agent skills for KiCad electronics design. Works with Claude Code and OpenAI Codex. Analyze schematics, review PCB layouts, EMC pre-compliance, SPI…

★ 1,3 mil estrelasMIT
Ver o guia →
Ferramentas de desenvolvimento

cc-switch

Cross-platform desktop all-in-one manager for Claude Code, Codex, OpenCode and other coding agents

★ 141,3 mil estrelasMIT
Ver o guia →
// alternativas

Alternativas em Ferramentas de desenvolvimento

Os outros projetos de Ferramentas de desenvolvimento com mais estrelas no catálogo do LibreAI — a lista realista de alternativas se harnessrouter não for o ideal para você.

// mais em devtools

Mais em Ferramentas de desenvolvimento

Projetos de Ferramentas de desenvolvimento próximos no catálogo, os mais próximos em estrelas de harnessrouter: continue explorando dos dois lados dele.

Baixe o harnessrouter

Grátis e aberto: pegue o código-fonte, dê uma estrela no repositório e comece a criar.