castellan plugin
List, inspect, scaffold, install, link, and uninstall dynamic plugins.
Usage
castellan plugin list
castellan plugin info <NAME>
castellan plugin new <NAME>
castellan plugin install --from <DIR>
castellan plugin install --git <URL> [--name <NAME>]
castellan plugin link --from <DIR> [--name <NAME>]
castellan plugin uninstall <NAME>
Installed plugins register via plugins.toml and build.rs — no hand-editing registry.rs.
Link vs install
install | link | |
|---|---|---|
| Sources | copied into crates/castellan-plugins/<name> | symlinked — edits are live |
| Iterate | re-install after every change | rebuild only (cargo build) |
| Uninstall | deletes the copy | removes the symlink, sources intact |
castellan plugin list reports "source": "builtin" | "install" | "link" per plugin.
Recipes
List registered plugins:
castellan plugin list
Install from local directory:
castellan plugin install --from ./my-plugin
cargo build --release -p castellan-cli # rebuild to register
Iterate on a plugin without reinstall:
castellan plugin link --from ~/src/my-plugin
cargo build --release -p castellan-cli # rebuild to register
# edit ~/src/my-plugin/src/lib.rs, rebuild — no re-link needed
castellan plugin uninstall my-plugin # removes only the symlink
Install from git:
castellan plugin install --git https://github.com/example/castellan-gridworld-extra.git
Uninstall:
castellan plugin uninstall sample-plugin