Get Started

Your own AI. Your own system. Free.

TreeOS is not a product. It is not for sale. It is already yours. Download a land, connect an LLM, and start building. The only cost is the hardware you run it on and whatever LLM provider you choose.

Join a Land or Make Your Own

You have two options. Join someone else's land, or run your own.

Join a Land

Someone you know is already running a land. They give you the URL. You register, connect your LLM, and start. Their server, their extensions, your trees. Your data lives on their land. Good for teams, families, small groups.

treeos connect https://their-land.com
treeos register
treeos start

Run Your Own

Download the land server. Run it on your laptop, a VPS, a Raspberry Pi, anywhere Node.js and MongoDB run. You control everything. Your data never leaves your machine.

npx create-treeos my-land
cd my-land
npm start
Full setup guide

CLI or Browser

Every land comes with two interfaces. The CLI is a terminal shell. The browser is server-rendered HTML pages. Use whichever you prefer. Both talk to the same tree.

CLI

npm install -g treeos

Navigate like a filesystem. cd, ls, chat, note. Named sessions let you hold parallel conversations at different positions. Extension commands appear automatically.

Browser

Open your land URL in a browser. The app shell gives you a chat panel and a viewport. Navigate trees, view dashboards, manage extensions. Some lands may not have HTML pages enabled. That's the operator's choice.

Choosing Extensions

When you first boot, the setup wizard asks which extension profile you want.

Minimal8 extensions. The kernel and navigation. Zero LLM usage when idle. For builders and testing.
Standard50+ extensions. Personal use. Cascade, intelligence, apps. Moderate LLM usage.
FullEverything. All 95 extensions. All gateways. All bundles. Recommended.

We recommend Full. You can always disable what you don't need later. Extensions that aren't relevant stay quiet. The system is designed for everything to be installed. You can also install individual extensions or bundles from the Horizon registry at any time.

Talking to Your Tree

The AI understands where you are. Navigate to a position and talk naturally. You don't need special syntax. Just say what you mean.

cd Fitness/Workouts
chat "add a back day with deadlifts and rows"
chat "I did 225x5 on deadlift today"
chat "how's my progress this week"

The AI reads the branch you're in, its notes, its children, its metadata. It responds from that position's perspective. Move somewhere else and the context changes.

Three Modes

Every message has an intent. The tree routes it to the right mode.

chatConversation. Ask questions, discuss, think out loud. The AI reads and responds but doesn't write.
placeWrite. The AI creates nodes, posts notes, updates values. It changes the tree.
queryRead-only question. The AI searches the branch and answers. No writes. No side effects.

In the CLI, these are commands: chat, place, query. In the browser, the chat bar sends as chat by default. Extensions add their own modes on top of these three.

Making Extensions

cp -r extensions/_template extensions/my-extension

Edit manifest.js to declare what you need and provide. Edit index.js to register hooks, modes, tools, routes, and slots. The loader handles the rest. Full reference at /build and /html.

Publish to the Horizon with treeos ext publish my-extension. Anyone on the network can install it with treeos ext install my-extension.

This is Yours

TreeOS is completely free. It is not a product. It is not a startup. It is a system for people to have their own AI, on their own terms, running on their own hardware.

The network compounds. Every extension someone publishes is available to everyone. Every improvement to a base extension benefits every land that uses it. The more people build, the more we all have. That's the point.

If someone wants to use a land to build a commercial product, they can. The base is there. But anyone, anywhere, can always download their own land and get started for free. No permission needed. No account required. No paywall.

The only things that stay private are custom extensions people choose not to share. That is their right. But we share all of ours to the world. They are a base and an example for people to build on and understand Tree. We are always looking for community improvements, even in our base extensions.

You don't need TreeOS at all. TreeOS is just the first operating system wrapped around the seed. The seed is the kernel: two schemas, a conversation loop, hooks, and a loader. You can build whatever you want on top of it. New shapes beyond a tree. New interfaces beyond CLI and HTML. The seed is the contract. Everything above it is a choice.