Quickstart

Install Castellan, bring up the multiplexer and dashboard, then land a first episode — under ten minutes when install works.

What you get

Binary on PATH → mux socket → dashboard → first episode JSON.

See it first

$ castellan plugin list
$ castellan run --goal "reach target" --plugin gridworld
episode satisfied

1. Install

curl -fsSL https://raw.githubusercontent.com/Alphabetsoup16/Castellan/main/install.sh | bash
castellan --version

From source: Install.

2. Mux + dashboard

castellan multiplexer ensure
castellan dashboard

Defaults:

• Socket: ~/.config/castellan/castellan.sock
• Episodes: .castellan/episodes/
• Config: castellan.toml when present

In another terminal:

castellan herd status

Quit the dashboard with q. Keybindings: Dashboard.

3. First episode through the mux

castellan run --goal "reach target" --plugin gridworld --mux

Episode JSON lands in .castellan/episodes/<goal-id>.json.

When an LLM/editor is wired, swap in a real goal — for example castellan run --goal "…" --plugin shell --mcp. See MCP overview and Agent guide.

Optional: offline smoke (no mux)

castellan run --goal "reach target" --plugin gridworld

Common commands

Next steps