Open Harness
Open Harness is an MIT-licensed TypeScript SDK for building Claude Code-style agents with stateless primitives and composable middleware.
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
- 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
- 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
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
3 free scans · no card needed
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.
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.
Average across the 2 sources that answered — each source counts once, not each post.
- +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.
- −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.
- • None — open-source and free. Costs arise from model API usage.
Viability Score
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
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
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.
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.
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.
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
- Build a CLI coding assistant that reads files, runs bash commands, and executes code
- Create a hierarchical multi-agent system where a supervisor delegates to specialized subagents
- Ship a web-based chat agent with typed streaming events and async tool approval modals
- Connect your agent to MCP servers over stdio, HTTP, or SSE for databases, APIs, or file systems
- Build a debugging assistant that compresses long conversation histories with two-phase compaction
- Wire composable middleware so retry, persistence, and turn tracking are opt-in per agent
- Drop automatic AGENTS.md and CLAUDE.md context injection into an existing repo workflow
- Add React or Vue agent UIs with typed streaming events
Models Under the Hood
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.
- — re-checked, vendor evidence unchanged
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-checked, vendor evidence unchanged
- — 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.
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
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.
Vercel AI SDK
Open-source TypeScript toolkit for building AI apps and agents across 100+ models with streaming, tools, and fallbacks
OpenAI Cookbook
OpenAI Cookbook is a free, MIT-licensed GitHub repository of example code and guides for working with the OpenAI API.
Eino
Eino is an open-source Go framework from ByteDance for building LLM apps, agents, and graphs in your existing Go backend.
Featured Head-to-Head Comparisons
Open Harness vs Locus Robotics
These tools solve entirely different problems. Locus Robotics is for operational teams needing to automate physical warehouse tasks at scale, with a RaaS model that requires financial commitment. Open Harness is a free, open-source SDK for developers building AI agents with full code control. Choose Locus if you move boxes; choose Open Harness if you move code.
Open Harness vs Presto Voice
Choose Open Harness if you're a developer needing a flexible, code-driven SDK to build custom AI agents with fine-grained control over state and middleware. Choose Presto Voice if you're a QSR chain operator seeking a proven, drive-thru-specific voice AI solution that boosts revenue through automation and upselling—especially with recent adoption by large brands like Dairy Queen.
Open Harness vs Truleo
Truleo is a purpose-built paid platform for law enforcement needing to unify siloed data into actionable leads. Open Harness is a free, open-source SDK for developers who want fine-grained control over AI agent workflows. Choose based on your domain: police work or code-first agent building.
Alternatives to Open Harness
View allVercel AI SDK
Open-source TypeScript toolkit for building AI apps and agents across 100+ models with streaming, tools, and fallbacks
OpenAI Cookbook
OpenAI Cookbook is a free, MIT-licensed GitHub repository of example code and guides for working with the OpenAI API.
Frequently Asked Questions
Categories
Topics
Used Open Harness? Help shape our editorial sentiment research.