Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduction

Castellan

Self-evolving agent coordination runtime — the harness is the castellan.

Install
curl -fsSL https://raw.githubusercontent.com/Alphabetsoup16/Castellan/main/install.sh | bash
Quickstart Daily driver Agent guide Socket API

Agents wake from a decaying pressure field, verify work through typed harness recursion (RAH), and improve topology from episode logs. Default castellan run is deterministic — wire LLMs via MCP, ACP, or remote panes when you need them.

Why Castellan

Typical harnessCastellan
CoordinationScripts / chatPressure field + scheduler
TopologyFixedEvolved from episodes
RecursionAPI subagentsRAH-verified multiplexer depth
ExecutionVendor PTYIn-tree mux + castellan dashboard

Episode flywheel

flowchart LR
    RUN[castellan run] --> LOG[.castellan/episodes]
    LOG --> EVOLVE[castellan evolve]
    EVOLVE --> GATE[castellan drift-check]
    GATE --> RUN

    classDef runtime stroke:#0969da,stroke-width:2px
    classDef evolve stroke:#d97706,stroke-width:2px
    classDef gate stroke:#1a7f37,stroke-width:2px

    class RUN,LOG runtime
    class EVOLVE evolve
    class GATE gate
  1. Run — castellan run or castellan run --rlm
  2. Log — episode JSON under .castellan/episodes/
  3. Evolve — topology mutations from the corpus
  4. Gate — castellan drift-check against the verification manifest
castellan run --goal "reach target" --plugin gridworld

Common commands

castellan run --goal "reach target" --plugin gridworld
castellan --help
castellan evolve --episodes 16 --workspace .castellan/episodes
castellan drift-check

Quickstart · Daily driver · What Castellan is / is not · CLI reference