deterministic-agent-control-protocol

Overview

The Deterministic Agent Control Protocol (Det-ACP) serves as a governance layer for AI agents, ensuring every action is bounded, auditable, reversible, and explainable. It works transparently with popular AI coding environments like Cursor, Claude Code, and Codex while providing a policy-based enforcement system that prevents harmful operations like deleting sensitive files or executing dangerous commands. The protocol supports multiple integration modes including MCP proxy for transparent tool interception, shell proxy for command governance, and HTTP API for language-agnostic integration.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• create_session

  Create a new governance session with a specified policy

  Try:Create a governance session for my coding agentTry:Start a new session with the devops-deploy policy
• evaluate

  Evaluate an action against governance policy without executing it

  Try:Evaluate if I can read the src/index.ts fileTry:Check if running npm install is allowed by policy
• record_result

  Record the result of an evaluated action in the audit ledger

  Try:Record the successful execution of the file read operationTry:Log the output from the command execution
• terminate_session

  End a governance session and generate an activity report

  Try:Terminate my current session with a completion reportTry:End the coding session and get my audit report
• proxy

  Start an MCP proxy that intercepts and governs tool requests

  Try:Start an MCP proxy with my coding policyTry:Launch a proxy server for my development environment
• exec

  Execute a shell command through the governance proxy

  Try:Execute echo 'hello world' through governanceTry:Run npm test through the shell proxy
• validate

  Validate a policy configuration file for syntax and rules

  Try:Validate my policy.yaml fileTry:Check if my devops policy is correctly configured
• report

  Generate an audit report from a ledger file

  Try:Generate a report from the audit ledgerTry:Show me all actions from the last session
• serve

  Start an HTTP session server for governance API access

  Try:Start the HTTP governance server on port 3100Try:Launch the session management API server

Note: Tools inferred from API examples and CLI commands, as no explicit 'Tools' section was found in the documentation. The actual MCP tools would likely be the underlying tools being governed (like file operations, commands, etc.) but these are

Comparable tools

Installation

npm install @det-acp/core

npx det-acp init cursor        # For Cursor
npx det-acp init codex         # For Codex CLI
npx det-acp init claude-code   # For Claude Code

{
  "mcpServers": {
    "det-acp": {
      "command": "npx",
      "args": ["-y", "@det-acp/core"]
    }
  }
}

FAQ

What agents are compatible with Det-ACP?

Det-ACP works with Cursor, Claude Code, Codex, and any MCP-compatible agent. It also supports shell-based agents through its shell proxy mode.

How does the policy system work?

Policies are defined in YAML files specifying allowed tools, paths, session limits, risk thresholds, and forbidden patterns. The protocol evaluates every action against these policies before execution.

On Hacker News

Recent discussion from the developer community.

• Show HN: DACP – governance gateway for AI coding agents▲ 2
  Story by elliot35 · 2026-02-10

Compare deterministic-agent-control-protocol with