Skip to content

Repository files navigation

HarnessRouter Starter

Starter demos and production-ready kits for HarnessRouter, the unified API for running agent harnesses such as Codex and Claude Code as your product backend.

An LLM returns tokens. A harness gives it a sandbox, tools, and a loop, so it returns the actual file. HarnessRouter lets your app send a task through one API and get back finished work.

This repository contains two MIT-licensed reference demos and separately licensed production kits. The Cursor-style coding app is the primary demo; LumaCare is a second reference demo showing how the same HarnessRouter patterns transfer to a different domain. The Slides Kit is a heavier product foundation with its own license terms.

Get your API key

  1. Create a HarnessRouter account. Signing up is free.
  2. Add a payment card to unlock the 500 free launch credits (limited-time offer).
  3. Follow the quickstart to create an API key, and for the primary demo, a coding agent whose agent ID you will reference below.

You can install and start either demo without a card. Credits are only consumed once the app sends tasks through your API key, and both demos run comfortably within the free credits.

Demos

1. Cursor-style coding app — primary demo

A coding-agent interface that demonstrates project-aware tasks, streamed output, persistent sessions, follow-up work, cancellation, and generated-file downloads. Watch the 55-second build video to see it running.

Open the Cursor-style demo guide

npm install
cp .env.example .env
# Add HR_API_KEY and HR_CURSOR_AGENT_ID to .env
npm run dev:cursor

Then open http://localhost:3000.

2. LumaCare — secondary reference demo

A family-care companion that uses the same secure streaming and session architecture in a healthcare-support experience.

Open the LumaCare demo guide

# Add HR_API_KEY to .env; LumaCare's agent mapping is checked in
npm run dev:lumacare

Then open http://localhost:3000.

Run one demo at a time because both use port 3000 by default.

Production kits

Slides

Slides is a production-ready presentation application foundation with an editable canvas, a conversational copilot, 46 templates, a slide-design Skill, and deck validation.

Open the Slides Kit guide

Launch it from Starter Kits in the HarnessRouter console. The console provisions the Harness and serves the app from the HarnessRouter image.

Repository structure

.
├── demos/
│   ├── 01-cursor-coding-app/  # Primary demo
│   └── 02-lumacare/           # Secondary reference demo
├── kits/
│   └── slides/                # Separately licensed production kit
├── .env.example               # Shared local configuration template
├── package.json               # npm workspace commands
└── README.md                  # Repository and demo index

Each demo owns its frontend, server, tests, agent mapping, and documentation. This keeps the two products independent while making their shared HarnessRouter architecture easy to compare.

Prerequisites

  • Node.js 22 or newer
  • A HarnessRouter API key (see Get your API key)
  • A HarnessRouter coding-agent ID for the primary demo

Commands

npm run dev:cursor   # Run the primary coding demo
npm run dev:lumacare # Run the secondary LumaCare demo
npm test             # Test both workspaces
npm run build        # Build and type-check both workspaces

Credentials belong in an ignored .env file and never in source control. See each demo's README for its configuration and architecture.

Licensing

This is a mixed-license repository:

  • Files without a more specific directory license, including the reference demos, are available under the repository MIT License.
  • kits/ is governed by the HarnessRouter Starter Kit License Agreement, not MIT. This covers every kit — slides, sheets, and any added later.
  • Individual local use is free, including learning, evaluation, personal projects, and the individual's own business operations.
  • Organizations using HarnessRouter Cloud for Internal Use do not pay a separate Kit license fee or have a Direct User limit; Cloud plan and usage charges still apply.
  • Non-Cloud Internal Use is free for up to three Direct Users. A paid entitlement is required before a fourth Direct User begins use or for separately metered automation.
  • Creating paid Client Deliverables or selling, deploying, hosting, or providing an End Product to an external customer requires the Commercial Use and Deployment Agreement and an applicable Order Form.
  • Sharing materials about your own business with investors, customers, advisers, and other counterparties is not Commercial Use merely because an external person receives them.
  • Generated presentations and exported files remain usable subject to the applicable Internal or Commercial Use rights.
  • Third-party components remain governed by their own licenses and notices.

The license included with a particular copy controls that copy. The current license structure does not revoke rights validly granted for an earlier copy under the license distributed with that earlier copy.

Learn more

About

Open-source starter demos for HarnessRouter: run agent harnesses such as Codex and Claude Code as your product backend through one API.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages