🏔

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.

Start a LandRead the Guide

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

cli
$ npm install -g treeos
$ treeos connect http://localhost:3000
$ treeos register
$ treeos chat "hello"
response
tabor@localhost/~ > chat "hello"
Tree: Welcome to your land. You have no trees yet.
Try: mkroot "My First Tree"
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.

Nineteen base extensions

Navigation, orchestration, dashboard, notifications, monitoring, team collaboration, presence detection, purpose tracking, cognitive phase awareness, and memory of what was lost. All loaded automatically.

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

plant a tree
$ treeos mkroot "Life"
$ treeos cd Life
$ treeos mkdir Health, Work, Projects
$ treeos cd Health
$ treeos chat "help me organize my health goals"
add an extension
$ treeos ext search fitness
$ treeos ext install fitness
$ treeos cd Health/Fitness
$ treeos fitness "bench 135x10"

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.