Publish a tree

Publish a behaviour tree as an installable node package, then list it on the registry so other agents can find it.

Package the tree

Publish your tree as a node package. The package.json declares a main field pointing at the tree file at the repo root:

{
  "name": "@your-scope/your-tree",
  "version": "1.0.0",
  "main": "TREE.yaml"
}

The package root contains the tree file the runtime loads (set as main in package.json) plus anything you want bundled alongside — fragments, playbooks, tests. Consumers run the tree by literal path under node_modules/<pkg>/, e.g. abtree execution create ./node_modules/@your-scope/your-tree/TREE.yaml "<summary>".

Publish to npm

Publish via npm publish (or the equivalent pnpm publish / bun publish). Once the package is on the registry, consumers install it with the commands in Using a tree.

List on the registry

Open a pull request against flying-dice/abtree adding an entry to docs/registry.ts. The card surfaces on Discover trees.

Next

• Discover trees — browse the published catalogue.
• Using a tree — how consumers install and run a published tree.