# Forge Os > The open-source control plane for AI agents — skill routing, context governance, trustworthy execution, evidence, security, and multi-agent orchestration. - **Type:** MCP server - **Install:** `agentstack add mcp-nolane-x-forge-os` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [Nolane-x](https://agentstack.voostack.com/s/nolane-x) - **Installs:** 0 - **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [Nolane-x](https://github.com/Nolane-x) - **Source:** https://github.com/Nolane-x/forge-os ## Install ```sh agentstack add mcp-nolane-x-forge-os ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About ForgeOS Skill Intelligence OS and Trust Control Plane for AI agents. ForgeOS decides which skill may run, which context may enter, which steps must be deterministic, and which evidence is strong enough to accept completion. 5-minute path · How it works · Ecosystem comparison · For developers · For experts · Tiếng Việt · 22 translations --- ## Why ForgeOS exists An agent does not become reliable because it has more prompts, more tools, or a longer context window. It becomes reliable when the system can answer six questions: 1. **What exact outcome is required?** 2. **Which technique is appropriate—and which similar techniques are wrong here?** 3. **What is the smallest context needed for this work unit?** 4. **Which steps must be deterministic rather than delegated to a model?** 5. **What independent evidence proves the output?** 6. **Can the same workflow recover, resume, and audit itself after failure?** ForgeOS v0.6 turns those questions into a runtime: ```text confirmed intent → outcome + technique retrieval → hard policy and anti-trigger filters → minimum RoutePlan DAG → isolated ContextPack per work unit → deterministic / agent / reflection execution graph → anchored outputs + coverage ledger → trusted receipts + evidence gates → release, rollback, recovery, and learning quarantine ``` It is not a prompt collection. It is the control plane around skills, rules, hooks, agents, tools, context, evidence, and learning. --- ## What is real in v0.6.1 | Surface | Verified implementation | |---|---:| | Legacy typed outcome scaffolds | **1,024** | | Deep Skill Contract v2 techniques | **128** | | L0 orchestration/trust/context techniques | **32** | | L1 cross-domain engineering techniques | **96** | | Independent evaluator bindings | **128** | | Skill catalog | **250** (**146** core, **104** domain) | | Stable procedural providers | **33** | | Candidate procedural providers | **242** | | Built-in skill + knowledge mappings | **1,299** | | Code Review Intelligence conformance cases | **12** | | Agent-surface adversarial cases | **20/20** | | Stable provider materialization | **33/33** | | Router Precision@1 / @3 | **93.75% / 100%** | | Router Recall@6 | **100%** | | Unsafe route activation | **0%** | > [!IMPORTANT] > The 1,024 legacy nodes are **outcome scaffolds**, not 1,024 production-grade procedural skills. v0.6 contains 128 deep technique contracts. Thirty-three procedural providers remain in the declared stable routing channel for compatibility, but the final certification audit finds 0/128 evidence-qualified stable and 0 certified under the Revision 2 Definition of Done. The remaining evidence requires holdout, paired multi-model, pressure, independent review, and production receipts. **Kernel inventory:** 32 L0 techniques + 96 L1 techniques = 128 deep kernel techniques. **Catalog routing states:** 33 declared stable-channel procedural providers and 242 candidates. **Formal certification evidence:** 0 stable-qualified, 0 certified. See [Final Certification Audit](docs/FINAL-CERTIFICATION-AUDIT.md). The release audit intentionally keeps these claims false: ```text 1,024 production-grade procedural skills false full PostgreSQL lifecycle HA false universal microVM sandbox false expert-labeled 200-PR review benchmark false 10,000 paired evaluation runs false ``` ForgeOS v0.6 does not claim universal production completeness or 1,024 production-grade procedural skills. See [Claims Boundary v0.6](docs/CLAIMS-BOUNDARY-V0.6.md). --- ## Universal lanes, governed execution The immutable [Universal Lane Registry](docs/UNIVERSAL-LANES.md) routes work across strategy and research, product UX/UI, visual media and 3D, software, data and AI, agents, security, cloud operations, commerce, education, hardware/manufacturing, and robotics/physical AI. A lane is a truthful routing and evidence contract—not a claim that ForgeOS can autonomously operate a factory, robot, payment flow, or production environment. Physical-world work remains human-approved. High-risk third-party execution requires a compatible configured remote provider; the local broker never pretends to be a microVM. See [Remote MicroVM Sandbox](docs/REMOTE-MICROVM-SANDBOX.md). --- ## Five-minute path Use this path when you want value without learning the Trust Kernel first. ### 1. Install ```bash npm install npm test node src/cli/forge.mjs init ``` Installed package: ```bash npx forgeos init forge doctor ``` `forge init` creates a safe local SQLite-WAL profile. Its API key is written to a `0600` file and is never printed. ### 2. Find the right technique ```bash forge skills search "react rerender" forge skills inspect reducing-react-render-thrashing forge route --query "compile the minimum context for a large monorepo" ``` ### 3. Inspect v0.6 ```bash forge v06 status forge profile plan coding --target codex forge security scan --file agent-surface.json ``` ### 4. Check the high-risk execution boundary ```bash node src/cli/forge.mjs sandbox status --json ``` Without a configured remote provider this intentionally returns `unavailable` and exit code `2`; ForgeOS never represents the local broker as a microVM. See [Remote MicroVM Sandbox](docs/REMOTE-MICROVM-SANDBOX.md) for the signed provider contract. ### 5. Start the local control plane ```bash npm start # Dashboard: http://127.0.0.1:8787/dashboard # MCP: http://127.0.0.1:8787/mcp # A2A: http://127.0.0.1:8787/a2a ``` --- ## Deep operator path Use this path when embedding ForgeOS into Codex, Claude Code, ChatGPT, an open-source agent, CI, or an internal platform. ### Skill Intelligence Router The router performs two-stage retrieval instead of matching a skill name: ```text intent / failed gate → outcome retrieval → direct technique-trigger retrieval → anti-trigger exclusion → trust, tenant, maturity, tool, license, freshness filters → measured-utility reranking → minimum technique DAG → provider resolution → frozen RoutePlan ``` Every selected and rejected technique has a reason. Hard blockers always beat score. ### Global Context Kernel v2 ForgeOS budgets the complete request: ```text system · task · selected skill sections · code symbols · artifacts · memory · tool output · references · lazy tool schemas · output reserve · safety reserve ``` It provides: - one token-accounting interface shared by resolver and materializer; - section-level skill loading; - isolated context per work unit; - lazy tool-schema materialization; - Semantic ABI symbol IDs and stale-hash rejection; - artifact delta projection; - scoped, expiring instinct injection; - content-addressed raw logs with distilled failure ranges; - an omission manifest for every source not included. ### Deterministic Skill Fabric A v0.6 technique is compiled into an executable graph: ```text Deterministic nodes scope-selection · bundling · rule-resolution · anchoring · evidence Agent nodes investigation · hypothesis · domain judgment Reflection nodes contradiction · false-positive filter · actionability Control nodes parallel join · coverage gate · retry · rollback ``` The SQLite coverage ledger uses leases, heartbeat, fencing, and trusted receipts. A reclaimed worker cannot mark a work unit complete. ### Code Review Intelligence vertical slice The first complete vertical slice proves the architecture end to end: ```text complete scope → relation-aware work units → contextual rule selection → isolated agent analysis → line/hash anchors → relocation after edits → independent reflection → coverage receipt ``` The bundled 12-case corpus is a deterministic conformance benchmark. It is **not** advertised as an expert-labeled 200-PR benchmark. ### Continuous Learning—without automatic self-poisoning Observed patterns become scoped instincts, not stable skills: ```text trusted run receipts → observed instinct → tenant/project/harness isolation + TTL → compatible instinct cluster → candidate evolution proposal → independent evaluation → human promotion or rollback ``` The producer cannot promote its own learned behavior. ### Harness Runtime v2 ForgeOS distinguishes four surfaces: | Surface | Use it for | |---|---| | **Rule** | Short invariant that must always apply | | **Hook** | Deterministic action bound to an event | | **Skill** | Conditional procedure requiring judgment | | **Agent role** | Separate context, tools, model, or authority | Neutral events include `before.tool.execute`, `after.file.write`, `verification.checkpoint`, `session.compact`, and `session.ended`. Host adapters must mark unsupported features instead of claiming false parity. Profiles: ```text minimal · coding · creative · research · regulated local-small · enterprise ``` ### Agent Surface Security The security engine scans the agent system itself: - instruction and prompt-boundary violations; - hooks and package lifecycle scripts; - MCP descriptions, permissions, and tool reachability; - command allowlists; - secret/environment references; - secret-to-egress permission paths; - pipe-to-shell and broad wildcard capability; - profile permission diffs before installation. Its adversarial corpus currently passes **20/20** cases. ### Brokered local execution The local runner provides a real safety boundary for normal commands: - no shell interpolation; - command and environment allowlists; - workspace and symlink containment; - timeout and process-group termination; - bounded stdout/stderr; - content-addressed execution receipt. It is **not** a universal network-denying microVM sandbox. High-risk third-party execution still requires an external container or microVM isolation layer. ForgeOS now has a fail-closed remote microVM control-plane adapter: it submits only to a configured HTTPS provider and accepts only request-bound, Ed25519-signed receipts with explicit network and secret isolation evidence. It never falls back to the local broker. The adapter is not a hosted microVM service; a compatible production provider remains an external deployment requirement. See [Remote MicroVM Sandbox](docs/REMOTE-MICROVM-SANDBOX.md). --- # How ForgeOS works ForgeOS combines two products in one runtime: 1. **A Skill Intelligence layer** that retrieves techniques, rejects unsafe near-matches, compiles only the required skill sections, and builds a frozen execution plan. 2. **An AI control plane** that manages projects, artifacts, evidence, approvals, leases, recovery, federation, and release gates. ```text confirmed intent or failed gate → outcome and direct-technique retrieval → anti-trigger, tenant, trust, tool, license, and freshness filters → minimum frozen RoutePlan DAG → isolated ContextPack per work unit → deterministic / agent / reflection Execution Graph → anchored outputs and fenced Coverage Ledger → trusted receipts and assurance-aware gates → release, recovery, rollback, or learning quarantine ``` ## Ten cooperating systems | System | What it controls | |---|---| | **Skill Intelligence Router** | Outcome retrieval, technique scoring, anti-triggers, hard policy, provider selection, and explainable RoutePlans | | **Global Context Kernel v2** | One total token budget across policy, task, skill sections, symbols, artifacts, memory, tool output, references, and output reserve | | **Deterministic Skill Fabric** | Hybrid graphs containing deterministic nodes, agent nodes, reflection nodes, approvals, anchors, and stop conditions | | **Coverage Ledger** | Work-unit ownership, leases, fencing tokens, completion coverage, stale-worker rejection, and resumability | | **Trust Kernel** | Evidence freshness, artifact lineage, approval authority, assurance levels, and release decisions | | **Agent Surface Security** | Prompt-injection patterns, dangerous package scripts, secret-to-egress paths, permissions, and adapter capability honesty | | **Brokered Local Execution** | Shell-free command spawning, allowlists, timeouts, output limits, and structured receipts | | **Continuous Learning** | Scoped instincts, expiry, confidence, quarantine, candidate proposals, and controlled promotion | | **Skill Federation** | Signed sources, trust tiers, quarantine, conflict handling, revocation, and synchronized catalogs | | **Harness Runtime v2** | Rules, hooks, skills, agent roles, permission diffs, and profiles for different AI harnesses | --- # Ecosystem comparison > [!IMPORTANT] > This comparison describes the **native, first-class focus of each core repository**. `◐` means partial support, extension-based support, or support through an adjacent product. `—` means it is not the project's primary focus, not that it is impossible to build. GitHub stars below are approximate figures checked on **July 26, 2026**. They indicate community visibility, not engineering quality by themselves. ## Ecosystem map | Project | Approx. GitHub stars | Primary role | |---|---:|---| | [Superpowers](https://github.com/obra/superpowers) | **255k** | Agent skill framework and software-development methodology | | [Anthropic Agent Skills](https://github.com/anthropics/skills) | **151k** | Skill standard and public skill library for Claude | | [LangChain](https://github.com/langchain-ai/langchain) | **139k** | Agent engineering platform and large integration ecosystem | | [OpenHands](https://github.com/All-Hands-AI/OpenHands) | **75k+** | End-to-end software-development agent application | | [CrewAI](https://github.com/crewAIInc/crewAI) | **56k+** | Multi-agent crews and event-driven flows | | [AutoGen](https://github.com/microsoft/autogen) | **50k+** | Multi-agent messaging and research runtime | | [LangGraph](https://github.com/langchain-ai/langgraph) | **37k+** | Stateful, long-running agent graphs | | [Semantic Kernel](https://github.com/microsoft/semantic-kernel) | **28k+** | Multi-language enterprise orchestration SDK | | [Awesome Agent Skills](https://github.com/VoltAgent/awesome-agent-skills) | **28k+** | Community catalog of more than one thousand skills | | [OpenAI Agents SDK](https://github.com/openai/openai-agents-python) | **27k+** | Agents, handoffs, guardrails, sessions, and tracing | | [smolagents](https://github.com/huggingface/smolagents) | **27k+** | Minimal agent library with code-agent emphasis | | [Letta](https://github.com/letta-ai/letta) | **23k+** | Stateful agents and persistent memory | | [Google ADK](https://github.com/google/adk-python) | **about 20k** | Code-first agent building, evaluation, and deployment | | [PydanticAI](https://github.com/pydantic/pydantic-ai) | **about 19k** | Type-safe Python agent framework | ## Core capability matrix | System | Packaged skills | Routing + anti-trigger | Governed context | Deterministic/agent hybrid graph | Evidence + trust receipts | Agent-surface security | Native strength | |---|:---:|:---:|:---:|:---:|:---:|:---:|---| | **ForgeOS** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | Skill intelligence and trustworthy execution | | Anthropic Skills | ✅ | ◐ | ◐ | — | — | ◐ | Simple, portable skill standard | | Superpowers | ✅ | ✅ | ◐ | ◐ | ◐ | — | Highly explicit SDLC methodology for coding agents | | Awesome Agent Skills | ✅ | — | — | — | — | ◐ | Skill discovery across many sources | | LangChain | ◐ | ◐ | ◐ | ◐ | ◐ | ◐ | Very large integration ecosystem | | LangGraph | ◐ | ◐ | ◐ | ✅ | ◐ | ◐ | Durable execution and stateful graphs | | OpenAI Agents SDK | ◐ | ◐ | ◐ | ◐ | ◐ | ◐ | Lightweight framework, handoffs, and tracing | | CrewAI | ◐ | ◐ | ◐ | ✅ | ◐ | ◐ | Role-based agents combined with Flows | | AutoGen | ◐ | ◐ | ◐ | ✅ | ◐ | ◐ | Event-driven multi-agent runtime | | Semantic Kernel / MAF | ◐ | ◐ | ◐ | ✅ | ◐ | ◐ | Enterprise orchestration across runtimes | | Google ADK | ◐ | ◐ | ◐ | ✅ | ◐ | ◐ | Build, evaluate, and deploy in Google's ecosystem | | PydanticAI | ◐ | ◐ | ◐ | ◐ | ◐ | ◐ | Type safety, validation, and Python ergonomic … ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [Nolane-x](https://github.com/Nolane-x) - **Source:** [Nolane-x/forge-os](https://github.com/Nolane-x/forge-os) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** yes - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-nolane-x-forge-os - Seller: https://agentstack.voostack.com/s/nolane-x - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.