Open Harness

Open Harness

Open Harness is an MIT-licensed TypeScript SDK for building Claude Code-style agents with stateless primitives and composable middleware.

66/100MonitorFreeFree

Open Harness is the right pick if you're building a coding agent and you've felt a heavier framework fight you over message history. You get plain arrays you can inspect and hand between agents, middleware you opt into one piece at a time, `approve` callbacks for gating tool execution, and subagent delegation you actually control — all on top of the Vercel AI SDK, so provider choice stays yours. What you don't get is a hosted control plane, a visual flow builder, or built-in long-term memory; this is a code-first library you self-host on Node.js or an edge runtime. Budget real TypeScript time. If you wanted drag-and-drop orchestration, look at a managed platform instead.

Verified 17h ago · liveness 66/100 · cite: rightaichoice.com/tools/open-harness

Best for
  • Developer-experience engineers building agent-powered IDEs or coding assistants
  • Backend developers wiring composable, stateless agent pipelines
  • AI engineers who need to inspect and modify message history directly
  • Teams building Claude Code-like products with custom orchestration
Not ideal for
  • Non-developers or anyone wanting a no-code agent builder
  • Teams that want managed cloud-hosted agents instead of self-hosting
  • Projects needing a visual flow designer or drag-and-drop interface
Visit Website

AdvancedUnder an hour for a developer comfortable with TypeScript and the Vercel AI SDK: npm install @openharness/core, define a model and tools, and stream events — the homepage's three-step path (Install, Configure, Run) is genuinely that short. Budget a day or more for the first real harness once you add middleware, approval callbacks, compaction, and MCP wiring, and longer if you are building the webWeb · CLIAPI availableVerified 17h ago
Pricing
Free
FreeFree tier
Learning curve
Advanced
Under an hour for a developer comfortable with TypeScript and the Vercel AI SDK: npm install @openharness/core, define a model and tools, and stream events — the homepage's three-step path (Install, Configure, Run) is genuinely that short. Budget a day or more for the first real harness once you add middleware, approval callbacks, compaction, and MCP wiring, and longer if you are building the web
Runs on
WebCLI
API available · 5 integrations
Who it's for
Developer-experience engineer building a coding assistantBackend developer wiring a multi-step agent pipelineAI engineer building a supervised multi-agent system
Live sentiment
Is Open Harness actually worth it?

We scan live Reddit threads, YouTube comments, X posts, G2 reviews and other communities — and hand you an honest verdict in under a minute.

  • Honest verdict, not marketing
  • Real pros & cons from real users
  • Attributed quotes with receipts
Run a free scan

3 free scans · no card needed

Skip it if

Skip Open Harness if you want a visual agent builder, a managed hosted runtime, or built-in long-term memory — this is an unopinionated TypeScript library you self-host on Node.js or an edge runtime.

The 30-second take
Price reality

Open Harness is an MIT-licensed SDK rather than a metered service, so the real cost is engineering time plus whatever you pay model providers directly — the homepage runs its example against openai("gpt-5.4"). That makes it cheaper than a managed agent platform at scale for teams with TypeScript depth, and more expensive in hours for teams without it.

In short

Open Harness — Open Harness is an MIT-licensed TypeScript SDK for building Claude Code-style agents with stateless primitives and composable middleware. Best for Developer-experience engineers building agent-powered IDEs or coding assistants, Backend developers wiring composable, stateless agent pipelines, AI engineers who need to inspect and modify message history directly. Free to use.

What people actually say about Open Harness — is it worth it?

We ran a structured research pass across product reviews, community discussions, and post-purchase forum threads to surface the patterns vendors won't publish themselves. Below: the recurring strengths, the hidden costs people mention most, and the cohort that consistently regrets adopting this tool.

30 mentions across 2 sources (Hacker News, Lemmy) · researched Jul 3, 2026.

50% positive50% critical

Average across the 2 sources that answered — each source counts once, not each post.

Recurring strengths
  • +Composable middleware for stateless agent building.
  • +Full control over message history and tool execution.
  • +Model-agnostic — works with any provider via Vercel AI SDK.
  • +Hierarchical subagents with background execution support.
  • +Built-in MCP integration via stdio, HTTP, or SSE.
Recurring frustrations
  • −Very early-stage with limited real-world validation.
  • −Small community — support relies on GitHub issues.
  • −Anthropic's open-sourced agent reduces differentiation.
  • −Requires TypeScript proficiency; not beginner-friendly.
  • −Minimal documentation and example projects available.
Patterns worth knowing
Ideal for developers frustrated with heavyweight agent frameworks
Seen on Hacker News
Early adopters value model-agnostic design and middleware
Seen on Hacker News
Anthropic's open-source agent framework reduces demand for Open Harness
Seen on Lemmy, Hacker News
Learning curve
intermediateProductive in ~A few hours
Hidden costs people mention
  • • None — open-source and free. Costs arise from model API usage.

Viability Score

66/100
Monitor

How well maintained and how widely used is Open Harness? Built from what the vendor actually publishes (docs, changelog, tutorials, integrations, pricing), whether the site is live, and how much real users discuss it. How we calculate this

Recent activity
not measured
Traction
100
Site health
95
User sentiment
50
What the vendor publishes
20

Last calculated: October 2026

How we score →

Key Features

  • Stateless agents with message history as plain arrays
  • Composable middleware for turn tracking, retry, compaction, persistence
  • Hierarchical subagents with background execution and Promise-like combinators
  • Two-phase context compaction: prune old tool results, then LLM summarization
  • Async tool permission callbacks for gating execution (approve hook)
  • MCP integration over stdio, HTTP, or SSE transport
  • On-demand SKILL.md instruction loading
  • Automatic AGENTS.md and CLAUDE.md project context injection
  • Built-in filesystem tools via NodeFsProvider
  • Built-in bash tool via NodeShellProvider
  • Typed event streaming (text.delta, tool.done, done) to CLI or web UIs
  • React hooks for web UIs
  • Vue composables for web UIs
  • Any model provider via Vercel AI SDK (OpenAI, Anthropic, Google)
  • Runs on Node.js and edge runtimes

About Open Harness

FreeAdvancedAPI availableWeb · CLI

Open Harness is an open-source TypeScript SDK (MIT licensed) maintained by MaxGfeller for developers who want to build AI agent harnesses — the Claude Code-style assistants that read files, run commands, and execute code — without handing the internals over to a framework. You install it with `npm install @openharness/core` and it sits on top of the Vercel AI SDK, so you can point it at OpenAI, Anthropic, Google, or any compatible provider; the vendor's own example wires the agent to `openai("gpt-5.4")`. The central design choice is that message history stays a plain array. You inspect it, edit it, or pass it between agents instead of extracting state from a hidden graph — the `done` event hands you back `event.messages`, which becomes the input to the next turn. Four primitives carry most of the work. Stateless agents keep history as plain arrays. Composable middleware lets you opt into turn tracking, retry, compaction, and persistence one piece at a time. Subagent hierarchies delegate to specialized child agents with background execution and Promise-like combinators. Two-phase context compaction prunes old tool results and then runs LLM-powered summarization. Around that you get async approval callbacks for gating tool execution (the docs show an `approve: async ({ toolName }) => ...` hook that works in CLI prompts or web modals), MCP integration over stdio, HTTP, or SSE, on-demand SKILL.md instruction loading, and automatic AGENTS.md / CLAUDE.md project context injection. Built-in filesystem and bash tools ship via NodeFsProvider and NodeShellProvider, and React hooks plus Vue composables cover web UIs. It suits developer-experience engineers building agent-powered IDEs or coding assistants, backend developers wiring composable agent pipelines, and teams shipping a Claude Code-like product with custom orchestration. Compared to a batteries-included framework, and to the raw Vercel AI SDK, Open Harness occupies the unopinionated middle: more structure than the SDK alone, far less magic than a full framework, and no hosted layer to depend on. You build and host the harness yourself on Node.js or an edge runtime, and model access flows through the Vercel AI SDK while external tools flow through MCP — those ecosystems define much of your integration surface.

Behind the Verdict

Open Harness is best understood as a set of unopinionated primitives rather than a product. The vendor's pitch is explicit — "No magic, no lock-in — just clean TypeScript APIs built on top of Vercel AI SDK" — and the homepage code samples back it up. A working agent is roughly a dozen lines: import `Agent`, `createFsTools`, `createBashTool`, `NodeFsProvider`, `NodeShellProvider` from `@openharness/core`, construct the agent with a model, tools, optional `systemPrompt` and `maxSteps`, then iterate over `agent.run(messages, input)` and switch on event types. That event surface is narrow and typed, which is the point. The documented events are `text.delta` (with `ev.text`), `tool.done` (with `ev.toolName`), and `done` (with `ev.messages`). Because `done` returns the full message array, continuation is just reassignment — no session object, no opaque graph. For anyone who has debugged state locked inside an agent framework, this is the strongest argument in the SDK's favor, and it is the thing competitors are least able to copy without a rewrite. Strengths, concretely: stateless message arrays; opt-in middleware for turn tracking, retry, compaction, and persistence; hierarchical subagents with background execution and Promise-like combinators; two-phase compaction (prune old tool results, then LLM summarization); async tool-permission callbacks for CLI prompts and web modals; MCP over stdio, HTTP, and SSE; SKILL.md loading; AGENTS.md/CLAUDE.md injection; filesystem and bash tools for Node.js; React hooks and Vue composables. Weaknesses are equally concrete. It is code-first with no visual editor, so non-developers are out of scope and non-TypeScript shops would be maintaining internals they aren't set up to own. The built-in filesystem and bash tools target Node.js specifically. Model access is mediated by the Vercel AI SDK — that is a feature for provider swapping, but it also means your provider roadmap is partly someone else's. External capability arrives through MCP servers, so your integration depth is a function of which MCP servers exist and how well they behave. There is no built-in long-term memory or vector storage layer; if you need durable recall across sessions you bolt on your own persistence middleware (the middleware hook exists for exactly this) and your own store. And there is no managed control plane: deploying, scaling, and watching agents in production is your problem, which is fine for a platform team and less fine for a two-person startup that wanted an agent shipped this quarter. The honest framing: Open Harness is infrastructure for people who intend to own their agent loop. If that's you, the plain-array message model, the `approve` gate, and the subagent combinators are worth the setup. If you want an agent you configure rather than build, this SDK is deliberately not that.

Researching Open Harness? Get your full AI stack in 60 seconds.

Free, no signup — tell us your goal and get tools matched to your budget & existing stack.

Real-world workflow fit

Concrete scenarios for the personas Open Harness actually fits — and what changes day-one when you adopt it.

Developer-experience engineer building a coding assistant

Run npm install @openharness/core, construct an Agent with openai("gpt-5.4") plus createFsTools(new NodeFsProvider()) and createBashTool(new NodeShellProvider()), and stream text.delta events to a terminal UI.

Outcome: A working CLI assistant that reads files and runs bash commands, with message history held as a plain array you can inspect and continue from the done event.

Backend developer wiring a multi-step agent pipeline

Stack opt-in middleware for turn tracking, retry, and persistence, add an approve callback that prompts for permission before each tool runs, and attach two-phase compaction so long sessions stay within the model's working context.

Outcome: A production-shaped agent loop where retries, approvals, and context pruning are individually switchable rather than baked into a framework's assumptions.

AI engineer building a supervised multi-agent system

Define a supervisor agent that delegates to specialized child agents using hierarchical subagents with background execution and Promise-like combinators, then connect those children to MCP servers over stdio or HTTP for database and file-system access.

Outcome: A supervisor/worker topology where each child runs as an isolated agent you can test and replace independently.

Use Cases

Models Under the Hood

gpt-5.4

as of 2026-10-10

Limitations

  • Open Harness is a code-first SDK: you build and host the harness yourself, and no managed cloud offering is mentioned.
  • Model access goes through the Vercel AI SDK and external tools through MCP, so those ecosystems define much of your integration surface.
  • There is no GUI for visual flow editing, and no built-in long-term memory or vector storage layer.
  • The documented built-in filesystem and bash tools (NodeFsProvider, NodeShellProvider) target Node.js, so non-TypeScript shops would be maintaining internals they aren't set up to own.

as of 2026-10-09

Verification history

We have re-verified Open Harness 8 times since . Each pass re-reads the vendor's own pages and re-checks every listed field against that evidence; passes where nothing had changed are marked as such.

  1. — re-checked, vendor evidence unchanged
  2. — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
  3. — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
  4. — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
  5. — re-checked, vendor evidence unchanged
  6. — re-checked, vendor evidence unchanged

Showing the 6 most recent of 8 verification passes.

Free to cite with attribution — this page re-verifies continuously.

12-month cost

Project the real annual outlay, including the implied monthly cost when only an annual tier is published.

Annual total
Free
Over 12 months
Effective monthly
Free
Billed monthly

Vendor list price only. Add-on usage, seat overages, and contract minimums are surfaced under Hidden costs & gotchas.

Plans compared

For each published Open Harness tier: who it actually fits, and what it adds vs. the previous tier. Cross-reference the cost calculator above for projected annual outlay.

Open Source

$0/mo

Ideal for

Developers and platform teams who are comfortable owning the agent loop and self-hosting it on Node.js or an edge runtime.

What this tier adds

Starting tier and the only published option: the MIT-licensed @openharness/core SDK at $0/mo.

Where the pricing makes sense

The company stage and team size where Open Harness's pricing actually pencils out — and where peers do it cheaper.

Open Harness is an MIT-licensed SDK rather than a metered service, so the real cost is engineering time plus whatever you pay model providers directly — the homepage runs its example against openai("gpt-5.4"). That makes it cheaper than a managed agent platform at scale for teams with TypeScript depth, and more expensive in hours for teams without it.

Setup time & first value

How long it actually takes to get something useful out of Open Harness — broken out by persona, not the marketing-page minute.

Under an hour for a developer comfortable with TypeScript and the Vercel AI SDK: npm install @openharness/core, define a model and tools, and stream events — the homepage's three-step path (Install, Configure, Run) is genuinely that short. Budget a day or more for the first real harness once you add middleware, approval callbacks, compaction, and MCP wiring, and longer if you are building the web

Integrations

OpenAIAnthropicGoogleModel Context ProtocolVercel AI SDK

Resources & Guides

Tutorials & Learning

YouTube returned 6 videos for “Open Harness”, and we withheld 6: 6 did not mention Open Harness. We are showing none, because we could not prove any of them are about Open Harness.

Official links

Tools that pair well with Open Harness

Common stack mates teams adopt alongside Open Harness, with the specific reason each pairing earns its keep.

Featured Head-to-Head Comparisons

Alternatives to Open Harness

View all
Vercel AI SDK

Vercel AI SDK

Open-source TypeScript toolkit for building AI apps and agents across 100+ models with streaming, tools, and fallbacks

FreemiumTry
OpenAI Cookbook

OpenAI Cookbook

OpenAI Cookbook is a free, MIT-licensed GitHub repository of example code and guides for working with the OpenAI API.

FreeTry
Eino

Eino

Eino is an open-source Go framework from ByteDance for building LLM apps, agents, and graphs in your existing Go backend.

FreeTry

Frequently Asked Questions

Used Open Harness? Help shape our editorial sentiment research.