The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Hypha
Harness-oriented agent system framework for production-grade LLM agent applications
Install
$
docker run -d --name hypha-mongodb -p 27017:27017 mongo:8Claude Code
claude mcp add hypha -- docker run -d --name hypha-mongodb -p 27017:27017 mongo:8Cursor / Claude Desktop (mcp.json)
{
"mcpServers": {
"hypha": {
"command": "docker",
"args": [
"run",
"-d",
"--name",
"hypha-mongodb",
"-p",
"27017:27017",
"mongo:8"
]
}
}
}Install command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →Agent Core + Production Harness for governed, durable, and reusable domain agents.
DomainPack · Event-first Runtime · Governed Capabilities · Recovery · Cache & Reuse
English | 中文
User Guide · Official Website · Release v1.0.1 · npm Packages
Current public release: v1.0.1, with 15 aligned packages named
@codesoul-co/hypha-*. The versioned user guide includes an API atlas for every package, custom FSM control, and a complete composition example.
What is hypha?
hypha is an open-source TypeScript framework built around two cooperating layers: an Agent Core and a Production Harness. The Agent Core handles reasoning/ReAct, planning, tool selection, Memory access, and model/context orchestration; the Production Harness turns those decisions into bounded, event-backed execution with FSM control, policy/approval, checkpoints, recovery, replay, and audit.
Product-specific behavior is declared through a DomainPack, not hard-coded into the runtime. A
DomainPack compiles tasks, workflows, capabilities, prompts, Memory, policy, evaluation, and output
contracts into the shared Core + Harness. A cross-cutting Cache & Reuse Plane then reuses
validated work across reasoning, tools, Memory, execution, and inference while remaining a disposable
projection: cache state can accelerate execution, but it can never become authority or replace Event,
Artifact, receipt, or checkpoint evidence.
Architecture at a glance
One Agent Core + Production Harness can be instantiated with different DomainPacks, while the Cache & Reuse Plane spans reasoning, tools, Memory, execution, and inference.
| Layer | Primary responsibility |
|---|---|
| Agent Core | Reasoning/ReAct, planning, tool selection, Memory access, model and context orchestration. |
| Production Harness | FSM execution, Event/checkpoint control, policy/approval, continuation, recovery, audit, and replay. |
| DomainPack | Declares the product-specific task, workflow, capability, Memory, Skill, Prompt, Policy, evaluation, and output contracts compiled into the shared runtime. |
| Cache & Reuse Plane | Reuses validated model work, reasoning structures, tool/execution results, Memory/context projections, and prefix/KV state without becoming a source of truth or authority. |
This separation is what lets the same runtime support very different agent products. A coding agent, finance agent, legal agent, or research agent can share the same Core + Harness while changing the DomainPack, capability bindings, policies, evaluation contracts, and domain-specific state.
Cache management and typed cache trees
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io