Treenity Starter

A typed tree runtime where AI agents operate safely.

Quick Start

git clone https://github.com/treenity-ai/starter.git
cd starter
npm install
npm run dev

Open http://localhost:3210

Single process: Vite 8 frontend + Treenity server on :3211.

Structure

starter/
├── data/base/       seed tree (FS mount)
├── data/work/       runtime data (overlay, gitignored)
├── mods/            local mods
├── src/main.tsx     frontend entry
├── root.json        server config
├── vite.config.ts   Vite + Treenity plugin
└── package.json     npm deps: @treenity/core, react, mods

Adding Mods

Create a mod in mods/your-mod/ with types.ts, service.ts, client.ts. Server auto-discovers mods on boot.

License

FSL-1.1-MIT