ruvnet/metaharness

698 stars · Last commit 2026-10-12

🛠️ The meta-harness for AI agents — scaffold your own focused, branded agent harness with its own npx CLI, MCP server, memory, learning loop, and witness-signed releases. Works with Claude Code, Codex, pi.dev, Hermes, OpenClaw, and RVM (hardware-isolated sandbox).

README preview

<div align="center">

# MetaHarness

<!-- readme-motion: hero -->
<a href="docs/visual-walkthrough.md"><img src="docs/assets/visuals/hero.svg" alt="MetaHarness: your repo, your agent, your harness. A layered rotating torus and orange trajectory introduce a factory for custom agent harnesses." width="100%"></a>
<!-- /readme-motion: hero -->

### Mint a custom AI agent harness from any repo.

`npx metaharness` · [open the Studio →](https://ruvnet.github.io/metaharness/)

<sub>(Repo: `ruvnet/metaharness` · CLI: `metaharness` · Library: `@ruvnet/agent-harness-generator`)</sub>

[![Open the Studio](https://img.shields.io/badge/Studio-open_in_browser_↗-7c5cff?style=for-the-badge&logo=githubpages&logoColor=white)](https://ruvnet.github.io/metaharness/)
[![User guide](https://img.shields.io/badge/User_guide-plain_language-22c55e?style=for-the-badge)](docs/USERGUIDE.md)
[![Tests — 2,254 passing](https://img.shields.io/badge/tests-2%2C254%20passing-22c55e?style=for-the-badge)](docs/ARCHITECTURE.md)
[![npm publish smoke](https://github.com/ruvnet/metaharness/actions/workflows/published-smoke.yml/badge.svg)](https://github.com/ruvnet/metaharness/actions/workflows/published-smoke.yml)
[![License MIT](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](LICENSE)

View full repository on GitHub →