DEDUPED Hot AI repos, turned into use cases Get the Monday 5

How to run agent tasks from your product backend through one API with Harnessrouter

Call a self-hosted, OpenAI Responses-compatible API to run harness tasks from your own backend.

Credentials. The HARNESSROUTER_API_KEY must stay on your backend and never be exposed in browser code.

Who it is forA developer building an AI product who needs agent tasks run by Codex or Claude Code without managing harness setup.

The problemEach agent harness has its own setup, sessions and failure handling, which slows down adding agent features to a product.

The outcomeYour backend sends a task with a harness ID, gets a response from the agent, and the task appears in the Console workspace.

What you need first

  • Docker installed
  • About 4 GB of free disk space
  • A provider API key for at least one supported model provider
  • Python 3 if you use the Idempotency-Key example

Steps

  1. Run docker run -d --name harnessrouter -p 127.0.0.1:3000:3000 -v harnessrouter:/data harnessrouter/harnessrouter (inferred, check the README)
  2. Run docker logs -f harnessrouter and wait for the line [harnessrouter] ready on :3000
  3. Open http://localhost:3000, sign in, change the default password in Profile, then add a provider key under Bring Your Own Key
  4. Create an API key under API Keys in the Console and store it as HARNESSROUTER_API_KEY in your backend
  5. Send a POST to /v1/responses with metadata.harness_id set to codex and a model served by your provider

Prompt for your agent

Using the HarnessRouter repo at https://github.com/HarnessRouter/harnessrouter, start a local Community Edition instance and send a POST to <base-url>/v1/responses with metadata.harness_id set to codex and the input 'Reply with exactly: it works.'. Expected output: a response whose text is 'it works.' and a matching task in the Console. Verify the HTTP status is 200 before reporting success.

Caveat. The default URL only works when your backend and the CE instance run on the same computer, so other machines or containers need a reachable URL.

Use this in your AI agent

Ask your agent

Using the Deduped MCP, get the setup steps for HarnessRouter/harnessrouter and "Run agent tasks from your product backend through one API"

Add Deduped to Claude Code once

claude mcp add --transport http deduped https://dedupedai.com/mcp

Cursor, ChatGPT, others

Share: X LinkedIn Hacker News Email Copy link

Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer