Cadre AI

Measure twice, code once.

Cadre AI is an open-source workflow harness for Codex, Claude Code, and Zed Agent. Published on npm as cadre-ai, it combines approved project context, spec-first plans, resumable execution, review gates, and parallel Git worktrees. All three client integrations are stable.

Get started Read the architecture

Claude Code

OpenAI Codex

Zed Agent

Human-governed workflow

Cadre validates every durable transition.

01

Create

02

Track

03

Implement

04

Review

05

Archive

Templates

Digests

Worktrees

Durable delivery without hidden workflow state.

The docs follow the actual create-to-archive lifecycle: context, planning, implementation, verification, review, learning, and recovery.

Upcoming, independently opt-in capabilities include GitHub/GitLab coordination for multiple people, a knowledge base built during work and reused as context, and polyrepo support. Each will be disabled by default. Explore the roadmap.

Human approval gates

Approved scope and your chosen approval mode govern delivery. Every clean track completion requires your explicit approval.

Resumable delivery

Project, track, operation, and execution journals reconcile repository and Git state after interruptions.

Safe parallel execution

Dependency-ready workers use isolated worktrees while the main agent owns scheduling, integration, and approval recording.

Documentation map

Start with installation and the first track, then go deeper into lifecycle rules, parallel execution, MCP tools, and recovery.

Getting Started

Architecture

Parallel Execution

Troubleshooting

All guides

Guides for installing cadre-ai, planning work, running coding agents, and reviewing changes with human approval.

23 pages

Start Here

Overview

Human-governed, Git-aware delivery for Codex, Claude Code, and the Zed Agent.

Start Here

Installation

Install, update, verify, and remove stable Codex, Claude Code, and Zed Agent integrations.

Start Here

Quickstart

Run a first human-approved Cadre track from project creation through archive.

User Guide

Capabilities

What Cadre supports today and where its boundaries are.

User Guide

How Cadre Works

Approval gates, versioned templates, durable journals, Git provenance, and recovery.

User Guide

Workflows

When and how to use Cadre's ten lifecycle skills.

User Guide

Parallel Execution

Dependency scheduling, isolated worktrees, approval gates, integration, and recovery.

User Guide

Parallel Walkthrough

Follow mixed phase concurrency, sequential tasks, task fan-out, worktree ancestry, approvals, and fan-in through one complete track.

Operations

Configuration

Configure Cadre through approved project context, workflow, styleguides, and track plans.

Operations

Tuning

Adjust context, planning, execution, verification, and approval without bypassing Cadre state.

Operations

Operations

Day-to-day status, recovery, refresh, review, archive, and plugin maintenance.

Operations

Roadmap (Coming Soon)

Optional GitHub/GitLab team coordination, a knowledge base built during delivery, and polyrepo support.

Operations

Troubleshooting

Resolve installation, MCP, state, journal, plan, worktree, integration, and review failures.

Contributor Guide

Architecture

Package layout, plugin assembly, runtime boundaries, and generated artifacts.

Contributor Guide

Runtime And MCP

The stdio server, immutable resources, tool families, schemas, and mutation guarantees.

Contributor Guide

Workflow Engine

How skills, MCP state transitions, journals, Git, and human decisions cooperate.

Contributor Guide

State And Artifacts

Sources of truth, generated indexes, operation journals, and project layout.

Contributor Guide

Development

Work safely in the Cadre harness and documentation workspace.

Contributor Guide

Testing And Release

Validate the runtime, package payload, native installers, and documentation before release.

Reference

Artifact Reference

Current project, track, execution, operation, styleguide, pattern, and derived artifacts.

Reference

Workflow Reference

Invocation, eligibility, mutations, and terminal outcomes for all ten Cadre skills.

Reference

MCP Reference

Immutable v6 resources and the 22 Cadre MCP tools.

Reference

Release Notes

Cadre release changes and migration guidance.