docker README

The project's README from github.com/decionis/docker. As one markdown file: README.md.

Decionis for Docker

CI License Go Report Card Coverage Go version Release decionis/mcp pulls desktop-extension pulls

Deterministic execution authority for AI agents and automated workflows running with Docker.

Decionis adds an explicit authority boundary between an AI agent's intent and consequential execution.

When an agent attempts a sensitive action—such as deploying infrastructure, modifying production data, publishing a package, invoking a privileged MCP tool, or performing another governed operation—Decionis evaluates the proposed action against deterministic, versioned policy before execution.

The result is an explicit decision:

PROCEED · HOLD · BLOCK

When policy requires human authority, Decionis Presence can request cryptographically verifiable human approval before execution continues.

Every governed decision can produce a signed Decision Dossier containing the policy, evidence, reason codes, evaluation metadata, and cryptographic proof behind the decision.


Why Decionis for Docker?

AI coding agents increasingly operate inside containers, development environments, CI/CD pipelines, and MCP-connected toolchains.

They can write code.

They can also:

terraform apply
npm publish
git push --force
docker run --privileged
database.drop
github.create_release

The question is no longer only:

Can the agent execute this tool?

It is:

Is the agent authorized to execute this action, under this policy, in this context, right now?

Decionis provides that authority layer.

AI Agent / Automation
        │
        │ proposes action
        ▼
┌──────────────────────┐
│       DECIONIS       │
│  Execution Authority │
│                      │
│ deterministic policy │
└──────────┬───────────┘
           │
    ┌──────┼──────┐
    │      │      │
 PROCEED  HOLD   BLOCK
    │      │
    │      ▼
    │   PRESENCE
    │   Human Authority
    │      │
    │   verified
    │      │
    └──────┴───────────► Execute
                         │
                         ▼
                  Decision Dossier

What this repository provides

decionis/docker is the open integration surface for running and experiencing Decionis in Docker-based developer environments.

The project is designed to include:

Decionis MCP Server

Run Decionis Execution Authority as a containerized MCP service for compatible agent environments and MCP clients.

Agents can request deterministic authorization before consequential tool execution and retrieve the resulting Decision Dossier.

Docker Desktop Extension

A native Docker Desktop experience for observing governed agent activity.

The extension is designed to surface:

Presence approval

A HOLD decision can require human authority before an agent continues.

Presence provides action-bound human verification using supported mechanisms such as passkeys and trusted-device approval.

Agent requests production deployment
              │
              ▼
          Decionis
              │
             HOLD
              │
              ▼
          Presence
              │
       Human approval
              │
              ▼
           PROCEED
              │
              ▼
           Execute

The agent does not decide whether human approval is necessary.

Policy does.

Dev Container governance

Decionis can be incorporated into Dev Container environments so execution governance travels with the development environment.

This enables teams to establish authority boundaries for AI-assisted development without relying on every developer or agent to implement governance independently.

Containerized execution gates

For agent architectures requiring an execution boundary, Decionis components can sit between an agent and consequential tools or APIs.

The goal is not generic network filtering.

Decionis evaluates the meaning of the proposed action—who or what requested it, what it intends to do, its risk and business context, and which policy governs execution.


Example

An AI coding agent decides that a production infrastructure change is required:

Action:       terraform.apply
Environment:  production
Requested by: AI coding agent
Risk:         HIGH

Before the operation executes, Decionis evaluates it:

Verdict:      HOLD
Policy:       production-infrastructure-v12

Reason:
Human authorization required for
production infrastructure changes.

Presence requests approval from an authorized human.

After successful verification:

Presence:     VERIFIED
Verdict:      PROCEED

Dossier:      dos_...
Evidence:     SIGNED
Algorithm:    Ed25519

Only then can the downstream system continue execution.


Architecture

Decionis deliberately separates intent, authority, human approval, and execution.

┌──────────────────────────────────────────┐
│              AI AGENT                   │
│ Claude · Cursor · VS Code · Custom      │
└────────────────────┬─────────────────────┘
                     │
                     ▼
┌──────────────────────────────────────────┐
│          TOOL / MCP LAYER                │
│ MCP · CLI · SDK · Agent Runtime          │
└────────────────────┬─────────────────────┘
                     │
                     ▼
┌──────────────────────────────────────────┐
│             DECIONIS                     │
│                                          │
│       Deterministic Authority            │
│                                          │
│ Policy · Context · Risk · Evidence       │
└────────────────────┬─────────────────────┘
                     │
               HOLD  │
                     ▼
┌──────────────────────────────────────────┐
│             PRESENCE                     │
│                                          │
│         Human Authority                  │
│                                          │
│ Passkey · Device · Verified Approval     │
└────────────────────┬─────────────────────┘
                     │
                     ▼
┌──────────────────────────────────────────┐
│             EXECUTION                    │
│                                          │
│ GitHub · AWS · DB · Terraform · APIs     │
└────────────────────┬─────────────────────┘
                     │
                     ▼
             DECISION DOSSIER

Decionis does not execute the action

Decionis is an execution-authorization control plane.

It evaluates proposed actions and returns an authority decision. It does not execute payments, deployments, database operations, trades, infrastructure changes, or other downstream actions.

Connected agents and systems remain responsible for execution.

This separation allows Decionis to govern consequential execution without becoming the system performing it.


Decision Dossiers

A governed action can produce an immutable Decision Dossier containing evidence such as:

Decision
Evaluation ID
Decision type
Verdict
Reason codes
Policy version
Execution context
Presence verification
Evidence hash
Signature
Timestamp

Dossiers are cryptographically signed using Ed25519 and can be independently verified.

This turns:

"The agent was allowed to do it."

into:

"Here is cryptographic evidence showing exactly why execution was authorized."


Use cases

Decionis for Docker is intended for consequential agent and automation workflows including:


Project status

This repository contains the Docker integration surface for Decionis.

Components will be released incrementally as the Docker developer experience evolves.

The initial focus is:

  1. containerized Decionis MCP execution authority
  2. Docker Desktop visibility into authority decisions
  3. Presence approval for held actions
  4. signed Decision Dossier inspection
  5. Dev Container integration

Security

Decionis is designed around a simple principle:

An AI agent's ability to call a tool is not the same as authority to execute the action.

Sensitive execution should cross an explicit, inspectable authority boundary.

If you discover a security issue, please follow the security reporting process described in SECURITY.md rather than opening a public issue.


Contributing

Issues, integration examples, documentation improvements, and contributions to the Docker integration layer are welcome.

The Docker integration surface is intentionally separated from Decionis's hosted control-plane implementation.

See CONTRIBUTING.md for contribution guidelines.


License

See LICENSE for licensing terms.


Decionis for Docker

Your agents have tools. Decionis decides when they can use them.%

docker (decionis/docker)

Searching Database…

165 ·GitHub
这是什么?Decionis for Docker 是面向 AI 智能体的执行授权层:在智能体执行敏感操作(如部署基础设施或调用特权 MCP 工具)之前,它会检查确定性策略并返回 PROCEED、HOLD 或 BLOCK。
它是我导入的库,还是挡在智能体前面的服务?它是一个控制面服务,不是你直接用来执行操作的工具。Decionis 评估拟执行的操作并返回决策,但实际执行仍由所连接的智能体或系统完成。
怎么在我的智能体环境中运行 Decionis?把 Decionis MCP 服务器作为容器化服务运行,让 MCP 兼容的智能体环境和客户端连接它;或者把它接入 Dev Container,让治理随开发环境一同携带。还计划推出一个用于查看决策和审批的 Docker Desktop 扩展。
使用它需要先具备什么?你需要 Docker,以及一个能在执行重要操作前调用 Decionis MCP 服务器的 MCP 兼容智能体或工具客户端;在审批方面,Presence 使用通行密钥(passkey)或受信设备验证。
这里描述的功能现在都已可用吗?没有——本仓库是 Decionis 的 Docker 集成入口,各组件(MCP 执行授权、Docker Desktop 可见性、Presence、Dev Container 支持)是逐步发布的,而非一次性全部推出。
Docker Desktop 部分只在 macOS 上能用,还是 Windows 和 Linux 也行?它作为 Docker Desktop 扩展构建,因此 Docker Desktop 能运行的地方(macOS、Windows、Linux)它都能运行;MCP 服务器本身只需要一个容器运行时。
如何确信决策事后没有被篡改?每个受治理的操作都可以生成一份经过签名的决策档案(Decision Dossier),包含所适用的策略、证据、原因代码和评估元数据,并使用 Ed25519 进行加密签名,可独立验证。
决策档案(Decision Dossier)到底是什么?它是受治理操作的不可变记录,由 Ed25519 签名,包含所适用的策略、证据、原因代码和评估元数据,把「智能体被允许这么做」变成关于为何授权执行的可验证证据。
Presence 是什么?Presence 是人工审批组件,在出现 HOLD 决策时介入,通过通行密钥或受信设备向被授权人员请求与该操作绑定的验证,之后智能体才能继续。
Decionis 会亲自执行那个高风险操作吗?不会。Decionis 只决定某个操作是否获得授权;实际执行仍由所连接的智能体或下游系统(部署工具、数据库、API 等)负责。
它适用于哪些类型的操作?影响重大、高风险的操作,例如生产部署、基础设施变更、特权 MCP 工具调用、数据库修改、软件包发布,以及金融或企业 API 操作。
Creator
decionis
Size
1.9 MB
Stars
165
Age
1mo
Commits · 90 Days