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

Daily driver loop

The recommended local workflow for developing and operating Castellan.

Loop

castellan multiplexer ensure  →  castellan dashboard  →  castellan run  →  castellan evolve  →  ./scripts/verify.sh
  1. Multiplexer — castellan multiplexer ensure starts the in-tree PTY server (~/.config/castellan/castellan.sock).
  2. Dashboard — castellan dashboard opens the ratatui control tower (agents, pressure, pane tree). Writes ~/.config/castellan/statusline.json for MCP observability.
  3. Run — castellan run --goal "…" --plugin gridworld (scheduler) or --rlm (verify/act loop with mux pane topology).
  4. Evolve — castellan evolve --episodes 16 --workspace .castellan/episodes mutates topology from episode corpus.
  5. Verify — ./scripts/verify.sh before every PR (fmt, clippy, hack, tests, smoke benches, dashboard + socket e2e).

Headless CI parity

CI runs the same smoke surface without a TTY:

cargo test -p castellan-dashboard --test integration
cargo test -p castellan-multiplexer --test socket_integration
castellan run --goal "reach target" --plugin gridworld --rlm

Remote / SSH

castellan remote --goal "reach target" --plugin gridworld
castellan herd attach --session my-work

See Dashboard and Verify.