Joch¶
Joch is the portable control plane for AI agent fleets. It manages the inventory, governance, portability, observability, and release lifecycle of agents built with any SDK — OpenAI Agents SDK, Claude Agent SDK, Google ADK, Microsoft Agent Framework, LangGraph, CrewAI, or your own Python and TypeScript code.
Joch is not another agent SDK, framework, or runtime. The vendor SDKs already cover code-first agents, planning, tool use, collaboration, state, guardrails, and human review. Joch sits above those SDKs and answers a different question: how do you operate, secure, and evolve a fleet of agents across vendors and frameworks?
What Joch is for¶
Joch answers operational questions that vendor SDKs leave to the operator:
What agents exist across my company, and who owns them?
What models, tools, MCP servers, and memory does each agent depend on?
What did each agent do yesterday, and what did it cost?
Which agents are using Claude, OpenAI, Gemini, or local models?
Can I move an agent from OpenAI to Claude — and what would break?
Can I block all agents from calling email.send without human approval?
Can I deploy the same agent locally, in Docker, and in Kubernetes?
Can I compare two agent versions before promoting to production?
Can I audit every tool call, memory write, and policy denial?
Which MCP servers are pinned, and which were quarantined this week?
If you are writing an agent today, you do not need Joch. If you are operating ten, a hundred, or a thousand of them — across teams, vendors, and environments — you do.
The five pillars¶
-
Inventory
A single system of record for every agent, model, tool, MCP server, memory, RAG source, deployment, and owner — regardless of which SDK built them.
-
Governance
Portable policy-as-code for tool use, data access, approvals, model choice, memory writes, and budgets — enforced uniformly across SDKs.
-
Portability
One agent record runs locally, in Docker, on Kubernetes, or via managed runtimes; conversation state migrates across providers without losing tools, memory, or artifacts.
-
Observability
Every model call, tool call, memory write, RAG retrieval, approval, cost line item, and artifact is captured as an event — exported to OpenTelemetry, OCSF, and your existing stack.
-
Release Management
Version, eval, diff, promote, roll back, and audit agents like production software, with quality gates that block regressions before they reach customers.
The strongest wedge¶
Joch is the secure MCP and tool-call gateway with an agent inventory layer.
Every major SDK is adopting Model Context Protocol (MCP) and tool calling. That creates a new enterprise problem — untrusted servers, unknown capabilities, no central approval, no shared audit trail, no schema-drift detection, no side-effect controls, no portable policy. Joch makes the tool boundary safe, then expands outward into full agent fleet management.
Explore the MCP gateway design · Explore the tool gateway design
OWASP AOS conformance¶
Joch implements the OWASP Agent Observability Standard as its conformance baseline:
- Inspect — every Joch agent emits an Agent Bill of Materials (AgBOM) extending CycloneDX, SPDX, and SWID.
- Instrument — Joch exposes the AOS hooks (
agentTrigger,toolCallRequest,toolCallResult,message,memoryContextRetrieval,memoryStore,knowledgeRetrieval, MCP, A2A) so any Guardian Agent canallow,deny, ormodifyagent decisions. - Trace — Joch trace events extend OpenTelemetry and OCSF schemas.
Read the AOS conformance index
Where to go next¶
-
Concepts
The product positioning, the five pillars in depth, the comparison against vendor SDKs, and a shared glossary.
-
Architecture
The control plane, data plane, framework adapters, tool and MCP gateways, policy engine, model router, and trust model.
-
Resources
Kubernetes-style YAML specifications for every resource kind in the Joch control plane.
-
AOS Conformance
How Joch implements the OWASP Agent Observability Standard for inspect, instrument, and trace.
-
Use Cases
End-to-end operator workflows: fleet inventory, MCP governance, cross-provider migration, cost control, release gates, approvals.
-
Business
Product positioning, moat, competitive landscape, revenue models, target audience, go-to-market, open-core strategy, and roadmap.
Open source¶
Joch is released under the Apache-2.0 license by PeasantsAI. The control-plane code, resource specs, AOS adapters, MCP gateway, and SDK adapters are all open. Hosted, multi-tenant features (joch cloud) are commercial.