mrkeyoor.com_
Wed 23 Sept 00:36 UTC
AI Toolsevaluationupdated 26 Aug 2026

agent-governance-toolkit review

Microsoft's Agent Governance Toolkit adds policy checks, identity, audit records, sandbox controls, and operational limits around AI agents. It wraps tool calls and agent actions in ordinary application code so an allow, deny, or approval decision can happen before the action reaches an external service.

+35stars / 7d
Verdict

Our measured Antigravity CLI subproject installed 7 packages and passed 22 tests, but npm audit found 2 high-severity vulnerabilities, so even the small path needs dependency review before use. Trial the toolkit when an agent can cause real external effects and your team can verify that interception actually fires on every supported host. Do not treat Public Preview status, a healthy dashboard, or a signed receipt as proof that the enforcement boundary is complete.

We ran it

Lab card: what happened when we ran agent-governance-toolkitScreenshot of agent-governance-toolkit (github.com/microsoft/agent-governance-toolkit)
Install✓ · 9s7 packages · 7 MB
Build✓ · 8s
Tests✓ · 7s22 passed · 0 failed of 22 (node:test)
Known vulns20 critical · 2 high · 0 moderate · 0 low (npm audit)
Repo4787 files~709,588 lines of source · 49.1 MB · 42 CI workflows · tests dir

Answers from our run

Does agent-governance-toolkit build from source?

Dependencies installed in 9 seconds (7 packages), and the build succeeded in 8 seconds. We cloned commit b570558 into a clean Debian container with 3 CPUs and no project-specific setup.

Do agent-governance-toolkit's tests pass?

Yes: 22 of 22 passed when we ran the project's own test command (node:test). Some failures need services or credentials a bare container does not have.

Does agent-governance-toolkit have known vulnerabilities in its dependencies?

npm audit flagged 2 known advisories in the dependency tree at the time of our run.

Who should not use agent-governance-toolkit?

Windows teams relying on the Claude Code plugin today: issue 3831 reports that governance hooks never fired while status still showed enforce mode, leaving no audit log or enforcement.

What are the alternatives to agent-governance-toolkit?

Open Policy Agent, Cedar. Our measured Antigravity CLI subproject installed 7 packages and passed 22 tests, but npm audit found 2 high-severity vulnerabilities, so even the small path needs dependency review before use.

Setup3/5Small measured CLI, but the full control plane spans many packages
Docs5/5Clear preview warning, package matrix, specs, and examples
Community4/56,128 stars and active issue work on August 25
Maturity2/5Public Preview with a reported silent Windows enforcement gap

Discussed on

  1. hnAgent Governance Toolkit5 points
  2. hnThe authentication in Microsoft's agent governance toolkit never runs3 points

Who it’s for

Platform teams deploying agents that can send messages, query data, run code, or call MCP tools.
Security engineers who want policy decisions and audit evidence outside the model prompt.
Organizations prepared to test a public-preview control layer against their exact framework, language, and operating system.
Teams that need Python breadth but also want narrower TypeScript, .NET, Rust, or Go SDK options.

Who it’s NOT for

Windows teams relying on the Claude Code plugin today: issue 3831 reports that governance hooks never fired while status still showed enforce mode, leaving no audit log or enforcement.
Buyers who require a stable general-availability contract: the README labels the toolkit Public Preview and warns of breaking changes before GA.
Rust teams assuming production parity with Python: issue 3680 lists incomplete workflow governance, persistence, observability, native integrations, and maintained performance baselines.
Operators who will treat generated compliance evidence as independent proof: issue 3805 asks whether receipt signing can be self-attested by the acting agent rather than an independent party.
Small agents with one low-risk local tool: this repository spans 4,787 files and about 709,588 source lines, and policy ownership may cost more than the risk it controls.

Setup reality

Our run measured only agent-governance-antigravity-cli/, not the whole multi-language toolkit. npm installed 7 packages in 9 seconds and used 7 MB. Its build passed in 8 seconds; node:test passed all 22 tests in 7 seconds. npm audit found 2 high-severity vulnerabilities and no critical, moderate, or low findings.

The Python quick start needs Python 3.11 or newer for the shown imports and a YAML policy. Azure features need client, tenant, and secret values. Framework adapters, MCP, identity, audit storage, approvals, and sandboxing add deployment-specific services and trust decisions.

The 49.1 MB repository held 4,787 files, about 709,588 source lines, 42 CI workflows, and a tests directory, with no Dockerfile detected. Language packages have different feature coverage, so validate the matrix and the exact integration path you plan to enforce.

Policy code can stop an action before the model reaches a tool

The toolkit's central idea is sound: prompts should not be the only place where an agent learns what it may do. A wrapper evaluates a policy before a tool call, records the decision, and can deny the call or require approval. The README shows a YAML rule blocking destructive database actions and another routing email sends to a security team.

That boundary matters when an agent can reach a database, shell, browser, or message service. It also creates a new responsibility. The wrapper must sit on every execution path, receive trustworthy identity and action data, and fail safely when policy or audit services are unavailable. One missed path can make 42 CI workflows and a detailed policy file irrelevant to the action that escaped them.

Public Preview covers many packages with unequal depth

Microsoft labels the project Public Preview and says breaking changes may arrive before general availability. The repository includes policy, mesh, runtime, SRE, compliance, marketplace, training, and hypervisor packages. It also lists an MCP security gateway, discovery tools, a dashboard, and integrations for many agent frameworks. Breadth is useful for evaluation and dangerous as a shortcut to assuming every surface is equally finished.

The README publishes packages for Python, TypeScript, .NET, Rust, and Go. Python has the full stack; the other SDKs implement a narrower core. Release v4.1.0 consolidated 45 prior Python packages into 5 top-level distributions and left old names as redirecting stubs. That cleanup helps installation, but upgrades still need import, policy, and behavior tests because older rule models were removed.

What happened when we ran it

Our sandbox tested commit b570558 in a Node 22 Debian container with 3 CPUs and 8 GB of RAM. The measured project lives under agent-governance-antigravity-cli/, so these results do not certify the Python core, every SDK, or every framework adapter. npm installed 7 packages in 9 seconds and used 7 MB on disk.

The subproject built in 8 seconds. Its node:test command finished in 7 seconds with 22 passed and 0 failed out of 22. npm audit reported 2 known vulnerabilities, both high severity, with 0 critical, moderate, or low findings. Before deployment, identify the affected dependencies and whether the execution path reaches them rather than dismissing or exaggerating the audit result.

The full checkout measured 49.1 MB, 4,787 files, and about 709,588 lines of source. Our scan saw 42 CI workflow files and a tests directory but no Dockerfile. We did not configure a policy service, run a governed agent, test a denial against an external tool, verify audit persistence, or exercise approval and recovery during a backend failure.

Windows Claude Code can report enforcement while hooks never run

Issue 3831 is the most important adoption warning we found. The reporter says the Claude Code plugin on Windows showed enforce mode and a healthy prompt-defense grade, while its session, prompt, and pre-tool hooks never executed. No audit log appeared. The reported cause is an extensionless shell launcher that Windows could not execute through the hook's spawn path.

The issue includes a direct node invocation as a tested fix, but an open report is not a released guarantee. Windows users should create a harmless denied tool, invoke it through the real Claude Code session, and verify both the denial and a new audit entry. A status page cannot substitute for that 2-part end-to-end check because this failure left status looking healthy.

Signed records prove integrity only within their trust model

Audit chains and signed receipts can show that a record was not changed after signing. They do not automatically show that an independent authority approved the action. Issue 3805 points out that the proposal and reference code may allow the acting agent's own process to hold the signing key. Such a receipt can be internally consistent while remaining self-attested.

For regulated or high-impact work, document who controls each signing key, which process may request signatures, how policy versions bind to decisions, and where logs are stored. Test deletion, clock errors, unavailable storage, and key rotation. The repository's 22 passing CLI tests say nothing about that deployed chain of custody, because our run did not create one.

Rust support is useful but not production parity yet

Issue 3680 is an umbrella proposal for Rust production parity. It names missing or incomplete workflow enforcement, durable state, observability, concrete framework integrations, and reproducible performance baselines. That is unusually candid scope information. Rust users should read it as a current boundary, not as a promise with a delivery date.

Open Policy Agent is a better fit when a company already has a policy service and only needs agents to submit decision inputs. Cedar is smaller when the problem is authorization rather than agent identity, SRE, and compliance tooling. Microsoft's toolkit earns a trial when those agent-specific layers would otherwise be built separately. The trial passes only when a denied action stays denied on each real framework, language, and operating system.

Alternatives

ProjectWhat it isPick it when
Open Policy Agent gh↗A general policy engine that evaluates structured input against Rego rules.pick this instead when you need a mature policy decision service and can build the agent interception, identity, and audit layers yourself.
CedarA policy language and evaluator designed for authorization decisions.pick this instead when authorization logic is the main requirement and you want a smaller engine rather than an agent operations suite.

What people are saying

  1. [github-trending] microsoft/agent-governance-toolkit

Sources

  1. Agent Governance Toolkit README
  2. Agent Governance Toolkit repository facts
  3. Agent Governance Toolkit v4.1.0 release
  4. Windows Claude Code hook issue 3831
  5. Rust production parity RFC 3680
  6. Compliance receipt signer issue 3805

More ai tools reviews

bkn-foundry · tokenizers · google-research · A2A · awesome-artificial-intelligence · ncnn · the whole board →