Skip to content

ChaosNexus Scripts Layout ​

Logical scripts root (workspace / polyrepo checkout):

chaosnexus-scripts/
├── plugins/           # discovered plugins (one folder per plugin)
│   ├── <name>/
│   │   ├── plugin.toml
│   │   ├── <entry>.rhai
│   │   └── .chaosnexus-forge/   # optional Forge canvas sidecars
│   └── disabled/      # never loaded
├── lib/               # shared import "lib/..." modules
├── .pending/          # quarantine (runtime; awaiting Forge approval)
├── data/              # optional shared data namespaces (runtime)
└── README.md

Discovery rules (Anvil) ​

PathLoaded?
plugins/<name>/Yes, if valid plugin
plugins/disabled/No
.pending/No until approved / moved
lib/On import "lib/...", not as MCP plugins

Pointing Anvil here ​

scripts_dir must be this root, not plugins/ alone (unless your tooling treats plugins as a child of the configured root). workspace default from chaosnexus-anvil/:

toml
scripts_dir = "../chaosnexus-scripts"

What is not in the public polyrepo ​

  • workspace tools/launch/ helpers
  • Local .chaoswrench_data/ event dumps (gitignored)