Citadel

Citadel

An open-source operating layer for Claude Code and OpenAI Codex.

Citadel routes requests, preserves repository state between sessions,
coordinates parallel work, applies repository safeguards, and records evidence
and handoffs around the coding agent you already use.

Install · Start using it · Trust boundary · Documentation

Install

Requires: Claude Code or OpenAI Codex, Node.js 22+, and a git repository.

Citadel is installed through the plugin marketplace already built into your
coding agent. The commands below pin the complete v1.4.4 release; if that tag
is not present on GitHub Releases,
do not substitute floating main.

Verified release · Project-local activation · Removable · No npm package

OpenAI Codex

Run these commands from the repository you want Citadel to manage:

Start a new Codex task, review Citadel through /hooks, then give it a real
request such as /do review README.md.

Claude Code

Run these commands from the repository you want Citadel to manage:

Run /reload-plugins if Claude Code is already open, then give Citadel a real
request such as /do review README.md.

Prefer to have your agent install it?

Paste this into Claude Code or Codex. It explains both what Citadel is and the
boundary the installer must preserve:

The platform owns plugin acquisition and executable-code trust. Citadel owns
bounded project state and recovery. Plans, digests, receipts, and doctor checks
remain available as evidence, but are not user chores on the normal path.

Manual, offline, and high-assurance installation

1. Open the GitHub Releases
   page and choose an explicit vX.Y.Z release.
2. Download citadel-vX.Y.Z.tar.gz, its .manifest.json, and its .sha256
   sidecar into one directory.
3. Compare the archive's SHA-256 with both published values before…