decapod

decapod

Decapod is the daemonless, local-first control plane that agents call on demand to align intent, enforce boundaries, and produce proof-backed completion across concurrent multi-agent work. πŸ¦€

Stars: 77

Visit
 screenshot

Decapod is a daemonless control plane for AI coding agents, providing a local-first state that can be verified. It is called on demand inside agent loops to lock intent, enforce boundaries, and prove completion with explicit gates. The tool shapes inference without doing inference, ensuring clear next actions, hard policy boundaries, and structured proof of completion criteria. State is stored locally in `.decapod/`, allowing shared context, decisions, and traces to persist across sessions. Decapod is agent-agnostic and safe for concurrent multi-agent execution.

README:

πŸ¦€

cargo install decapod && decapod init

Decapod
A daemonless control plane for AI coding agents.

Called on demand inside agent loops. No background process, no new workflow, local-first state you can verify.

CI crates.io License: MIT Ko-fi


Why Decapod 🧠

AI coding agents are strong at generating code. Most failures happen before and after generation: unclear intent, fuzzy boundaries, and weak completion checks.

Decapod is the missing layer in that loop. Agents call it mid-run to lock intent, enforce boundaries, and prove completion with explicit gates. It shapes inference without doing inference.

Decapod is daemonless. There is no long-lived service. The binary starts when an agent calls it and exits immediately after the call.

"Just use Decapod" is literal:

  • cargo install decapod
  • decapod init

Then continue with Claude Code, OpenAI Codex, Gemini CLI, Cursor, or any tool that can invoke a CLI command. Decapod is agent-agnostic and safe for concurrent multi-agent execution.

State is local and durable in .decapod/: shared context, decisions, and traces persist across sessions and remain retrievable over time.

Related: Evaluating AGENTS.md (ETH SRI, 2026) on context-file quality and agent cost/performance.

β˜• Like Decapod? Buy us a coffee on Ko-fi πŸ’™

Assurance Model βœ…

Decapod centers execution around three outcomes:

  • Advisory: clear next actions that tighten intent and reduce wasted loops.
  • Interlock: hard policy boundaries that block unsafe or out-of-contract flow.
  • Attestation: durable, structured proof that completion criteria actually passed.

Operating Model βš™οΈ

Human Intent
    |
    v
AI Agent(s)  <---->  Decapod Runtime  <---->  Repository + Policy
                         |    |    |
                         |    |    +-- Interlock (enforced boundaries)
                         |    +------- Advisory (guided execution)
                         +------------ Attestation (verifiable outcomes)

Features ✨

  • On-demand CLI/RPC control plane agents call during work, then exit.
  • Early intent capture and explicit task boundaries before implementation commits.
  • Deterministic policy gates that produce concrete pass/fail completion signals.
  • Repo-native durable state in .decapod/ for historically retrievable traces and decisions.
  • Shared cross-agent context that survives sessions and handoffs.
  • Multi-agent-safe coordination for concurrent Claude/Codex/Gemini/OpenCode workflows.

Getting Started πŸš€

cargo install decapod
decapod init

Then keep using your agents normally. Decapod is called from inside those agent runs when control-plane decisions are needed.

Agent integration: If you use Claude Code / Codex / Gemini / Cursor / similar tools, see AGENTS.md and the tool-specific entrypoint files (CLAUDE.md, CODEX.md, GEMINI.md) for the exact operational contract.

Learn more about the embedded constitution via the CLI:

decapod docs show core/DECAPOD.md

Override constitution defaults with plain English in .decapod/OVERRIDE.md.

Contributing 🀝

git clone https://github.com/DecapodLabs/decapod
cd decapod
cargo build
cargo test
decapod validate

Documentation πŸ“š

Support πŸ’–

License πŸ“„

MIT. See LICENSE.

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for decapod

Similar Open Source Tools

For similar tasks

For similar jobs