🏔

Your Land

A land is your server. It stores your trees, runs your AI, hosts your extensions, and connects to the network. You own it. Your data stays on it.

What is a land

🖥

Your server

A land is a Node.js server connected to MongoDB. It runs on your machine, your VPS, or any hosting provider. You control it.

🌳

Your trees

Trees live on your land. Your notes, your nodes, your conversations, your AI context. Nothing leaves unless you peer with another land.

🧠

Your AI

You connect your own LLM. OpenAI, Anthropic, Ollama, any OpenAI-compatible endpoint. The AI thinks at every position in your tree using the model you chose.

What you need

Three things. That's it.

1

Node.js 18+

The runtime. LTS recommended.

2

MongoDB

Local install or MongoDB Atlas. Free tier works.

3

An LLM API key

OpenAI, Anthropic, or any OpenAI-compatible endpoint.

Start a land

One command. Interactive setup walks you through the rest.

terminal
$ npx create-treeos my-land
$ cd my-land
$ npm start
Welcome to TreeOS.
First-run setup. Answer a few questions to configure your Land.
Domain (localhost): mysite.com
Land name (My Land): Research Lab
Port (3000):

Connect to your land

Two ways in. Both work. Use whichever feels right.

Browser

Open http://localhost:3000 in your browser. Register, set up your LLM, and start chatting. Natural language works. Just type.

Say hello. Ask a question. Log food. Start a study session. The tree figures out what to do based on where you are.

CLI

terminal
$ npm install -g treeos
$ treeos connect http://localhost:3000
$ treeos register
$ treeos start
you@localhost/~ > hello
Home: Hey! You have no trees yet. Try: life food fitness
CLI Reference

What's running

After first boot, your land has:

Three zones

Land root (/) for system management. Home (~) for personal space. Trees for everything else. Navigate with cd.

77 extensions on standard

Intelligence, cascade, proficiency apps (food, fitness, study, recovery, KB), navigation, orchestration, dashboard, notifications, monitoring, and more. 105 total available. Install what you need.

Six system nodes

Land root, identity, config, peers, extensions registry, and flow (cascade signal history). Created at boot. Managed by the kernel.

The AI

Connected to your LLM. Thinks at every position. Navigate to a node and chat. The AI knows where it is, what tools it has, and what extensions are active.

First things to do

Natural language works everywhere. Just type what you mean.

get started
you@localhost~ > life food fitness study recovery
Creating your Life tree...
Scaffolded: Food, Fitness, Study, Recovery
you@localhost/Life > I had eggs and toast for breakfast
Logged. 310 cal, 18g protein.
you@localhost/Life > bench 135x10x10x8
Push day logged. Bench up from 130 last session.
you@localhost/Life > go food
Navigating to /Life/Health/Food
you@localhost/Life/Health/Food > how am I doing this week
Averaging 1,850 cal. Protein at 82%. Breakfast consistency improving.

One command scaffolds your whole stack. Then just talk to it. The tree routes to the right extension.

Growing your land

Three paths forward.

Add extensions

Browse the directory. Install what you need. Each extension adds tools, commands, and AI behavior. Your land becomes what you install.

Browse extensions

Connect to the network

Peer with other lands. Discover public trees. Contribute to trees on other lands. Your data stays on your land. Context travels.

The network

Read the guide

Everything in one place. CLI commands, extension format, configuration, federation.

Full guide

Review every extension before you install it.

The kernel is safe. Extensions have full access. A malicious extension with the right tools can access your file system, make network calls, and execute shell commands. Read the code before you install from unknown sources.

Use ext view to inspect before you ext install. Use spatial scoping to confine dangerous extensions to specific branches.