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
Docker
Что это?Decionis for Docker — слой полномочий на выполнение для ИИ-агентов: прежде чем агент выполнит чувствительное действие вроде развёртывания инфраструктуры или вызова привилегированного MCP-инструмента, тот проверяет детерминированную политику и возвращает PROCEED, HOLD или BLOCK.
Это библиотека для импорта или сервис, стоящий перед моим агентом?Это сервис управляющего уровня (control plane), а не то, чем выполняют действия напрямую. Decionis оценивает предлагаемые действия и возвращает решение, но фактическое выполнение всё равно осуществляет подключённый агент или система.
Как запустить Decionis вместе со своей агентной настройкой?Запустите MCP-сервер Decionis как контейнеризованный сервис, к которому подключаются совместимые с MCP агентные среды и клиенты, или встройте его в Dev Container, чтобы управление перемещалось вместе со средой разработки. Также планируется Docker Desktop Extension для просмотра решений и согласований.
Что должно уже быть, чтобы этим пользоваться?Нужны Docker и совместимый с MCP агент или клиент инструментов, который сможет вызывать MCP-сервер Decionis перед выполнением значимого действия; для согласований Presence использует passkey или проверку доверенного устройства.
Всё ли описанное здесь уже доступно сегодня?Нет — этот репозиторий является поверхностью интеграции Decionis с Docker, и компоненты (MCP execution authority, видимость в Docker Desktop, Presence, поддержка Dev Container) выпускаются постепенно, а не всё сразу.
Часть для Docker Desktop работает только на macOS или ещё на Windows и Linux?Он сделан как Docker Desktop Extension, поэтому работает там, где работает Docker Desktop (macOS, Windows, Linux); самому MCP-серверу достаточно среды запуска контейнеров.
Как убедиться, что решение не подделали потом?Каждое контролируемое действие может создать подписанный Decision Dossier с политикой, доказательствами, кодами причин и метаданными оценки, криптографически подписанный Ed25519, чтобы его можно было проверить независимо.
Что такое Decision Dossier в точности?Это неизменяемая подписанная Ed25519 запись о контролируемом действии, содержащая применённую политику, доказательства, коды причин и метаданные оценки; она превращает «агенту разрешили это сделать» в проверяемое подтверждение того, почему выполнение было авторизовано.
Что такое Presence?Presence — компонент человеческого согласования, который включается при решении HOLD и запрашивает у авторизованного человека проверку, привязанную к действию, через passkey или доверенное устройство, прежде чем агенту разрешат продолжить.
Выполняет ли Decionis сам рискованное действие?Нет. Decionis лишь решает, авторизовано ли действие; фактическое выполнение остаётся ответственностью подключённого агента или нижестоящей системы (инструмент деплоя, база данных, API и т.д.).
Для каких типов действий это предназначено?Значимые высокорисковые операции: деплои в продакшен, изменения инфраструктуры, привилегированные вызовы MCP-инструментов, изменения баз данных, публикация пакетов, финансовые или корпоративные API-операции.
What are similar projects?strix, ai-agents-the-definitive-guide, cynative, paperclip, awesome-mcp-servers, Anthropic-Cybersecurity-Skills, agent-safe-pipeline, AgentTeams
Which topics is it in?policy-engine, mcp-servers, security-automation, ai-governance, ai-security, human-in-the-loop, cryptography, ai-tools, agentic-ai, mcp-server, ai-agent, go
Creator
decionis
Size
1.9 MB
Stars
165
Updated
CommitAug 25Releasecli-v0.1.0Aug 18
Age
1mo
Commits · 90 Days