Practical overview
When it fits
Use Metaharness when a repository-aware, customized agent harness is more relevant than adopting a general-purpose agent framework. Its repository-scoring command is suited to an initial assessment before generation.
Who it is for
- Developers creating custom AI-agent harnesses for repositories.
- Teams that want project-scoped agent skills, commands, tools and memory.
- Builders targeting Claude Code, Codex, pi.dev, Hermes, OpenClaw or RVM.
Documented uses
- Generate a custom harness from a GitHub repository or blank slate.
- Distribute a generated harness through a custom npx CLI.
- Expose harness functionality through an MCP server.
- Add project-scoped memory and learning-loop components.
- Inspect a repository's harness fit before scaffolding it.
Requirements & limits
The project is available as a public MIT-licensed repository. The documented interfaces include the `npx metaharness` CLI and a browser-based Studio.
- The project can generate a branded harness and custom npx command rather than only provide an agent runtime.
- MCP support is explicitly included, while client-specific compatibility is not demonstrated in the supplied material.
- The score command reads a repository without running it and provides pre-scaffolding information about fit, build likelihood, tool safety and rough run cost.
- The implementation is TypeScript and names Claude Code, Codex, pi.dev, Hermes, OpenClaw and RVM as target environments or integrations.
- The complete generator configuration and generated output structure are not specified.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Scaffold a harness from a repository using a template
List available templates and generate a harness named `my-bot` with the coding vertical template.
Before you start
- Node.js/npm environment capable of running
npx.
Steps
Run the command below to view available templates.
npx metaharness --listRun the command below to scaffold the harness.
npx metaharness my-bot --template vertical:coding
Expected outcome
A `my-bot` harness is scaffolded using the coding vertical template.
Guide limitations
- The source does not specify the full set of generator options or the generated directory structure.
- The template description says shipped settings are default-deny; it does not detail how to configure them.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 4 October 2026
- Original website title
- ruvnet/metaharness · Official homepage title · retained in its source language

