The CLI

Just type. It understands.

Natural language in the shell. Say what you mean and the tree figures out what to do. Commands exist for when you want precision. But you never need them.

Talk to It

treeos
tabor@treeos.ai/Health I had eggs and toast for breakfast
Logged. 310 cal, 18g protein, 24g carbs.
tabor@treeos.ai/Health how many calories am I at today
620 cal so far. 1,380 remaining for your 2,000 target.
tabor@treeos.ai/Health bench 135x10x10x8, OHP 95x8x8x6
Push day logged. Bench up from 130 last week. OHP holding steady.

If the first word isn't a command, the shell sends it straight to the AI. The tree reads your position, picks the right mode, and responds. No prefix. No quoting. Just type.

You Already Know This

It works like a filesystem.

treeos
tabor@treeos.ai~ ls
Health Projects Journal
tabor@treeos.ai~ cd Health
tabor@treeos.ai/Health ls
Fitness Food Recovery Study
tabor@treeos.ai/Health cd Fitness
tabor@treeos.ai/Health/Fitness tree
Fitness
Push
Bench Press
OHP
Pull
Pull-ups
Rows
Legs
tabor@treeos.ai/Health/Fitness mkdir Cardio
Created Cardio
tabor@treeos.ai/Health/Fitness cd ..
tabor@treeos.ai/Health pwd
/Health

cd, ls, tree, mkdir, pwd, mv, rm. If you have used a terminal, you can use TreeOS. The tree is a filesystem where AI lives at every node.

Three Zones

Where you are changes what the AI can do.

treeos
tabor@treeos.ai/ what extensions are loaded
Land zone. 114 extensions loaded, all healthy.
tabor@treeos.ai/ cd ~
tabor@treeos.ai~ what have I been working on
Home zone. Most active in Health and Projects this week.
tabor@treeos.ai~ cd Health
tabor@treeos.ai/Health add a back routine to my pull days
Tree zone. Created Back and Biceps under Pull. Pull-ups 4x8, Rows 3x10.
cd /land zone. manage your server.
cd ~home zone. your trees, your ideas.
cd Healthtree zone. AI works the branch.

No mode picker. No settings. Just cd.

Four Ways to Talk

Most of the time you just type. But when you want to be specific.

chatyou steer, the AI responds
placethe AI stores what you said
querythe AI answers without changing anything
bethe tree leads, you follow
treeos
tabor@treeos.ai/Health/Fitness chat what should I work on today
Pull day. You haven't hit back since Tuesday.
tabor@treeos.ai/Health/Fitness place deadlift 315x5x5x3
Stored under Pull/Deadlift. 315x5/5/3. New PR on first set.
tabor@treeos.ai/Health/Fitness query what was my deadlift last month
295x5x5x5 on March 3.
tabor@treeos.ai/Health/Fitness be
Your pull volume is high but you haven't stretched in 6 days.
Want to add a mobility block?

chat, place, and query are conversations where you steer. be is different. The tree reads everything, finds what needs doing, and guides you one step at a time. One word. The tree takes over.

These are optional. Typing naturally without a command prefix does the same thing. The tree classifies your intent automatically. Commands are for when you want to tell it exactly how to think.

Extensions Add Commands

Every extension brings its own verbs. The help menu updates at every position.

treeos
# proficiency extensions
tabor@treeos.ai/Health food eggs and coffee for breakfast
Logged. 224 cal, 15g protein.
tabor@treeos.ai/Health fitness bench 135x10x10x8
Push day logged. Bench up from 130 last session.
tabor@treeos.ai/Health recovery slept 7 hours, feeling good
Checked in. Sleep trending up this week.
tabor@treeos.ai/Health study status
Active: distributed systems (72% mastery)
Queue: compilers, category theory
# intelligence extensions
tabor@treeos.ai/Health explore what do I know about protein
Found 8 nodes across Food and Fitness. Triangulating...
tabor@treeos.ai/Health understand
Compressing /Health into knowledge... 34 nodes processed.
# subcommands
tabor@treeos.ai/Health food-daily
Today: 1,640 cal, 112g protein. On track.
tabor@treeos.ai/Health kb status
84 entries. 3 stale. 1 unplaced.

Each command activates a different AI mode at your position. food is a nutritionist. fitness is a coach. explore is a researcher. understand compresses the branch into knowledge. Same tree. Different minds.

You can also just type naturally and the tree will route to the right extension. Extension commands are shortcuts for when you want to be explicit or when similar extensions overlap at the same position.

Sessions

Pin a conversation to a position. Talk to it from anywhere.

treeos
tabor@treeos.ai/Health @fitness whats my bench PR
135x10 on March 26.
tabor@treeos.ai/Health @fitness › add a back day
Created Back and Biceps. Pull-ups 4x8, Rows 3x12.
tabor@treeos.ai/Health @fitness › @food how much protein today
82g so far. You want 150. Need about 70g more.
tabor@treeos.ai/Health @food › @fitness
Back in fitness session. Last: added Back and Biceps.
tabor@treeos.ai/Health @fitness › sessions
@fitness /Health/Fitness (active)
@food /Health/Food
tabor@treeos.ai/Health @fitness › @default
Back to default session.
tabor@treeos.ai/Health _

@fitness creates a session pinned to /Health/Fitness. Navigate anywhere and the session stays put. Come back with @fitness from anywhere. Each session remembers its own conversation. Close the shell, come back tomorrow, pick up where you stopped.

sessionslist all active sessions
sessions kill fitnessend a session
@defaultswitch back to default session

Context Carries

treeos
tabor@treeos.ai/Health food eggs and toast for breakfast
Logged. 224 cal, 15g protein.
tabor@treeos.ai/Health fitness what should I do today
224 cal in so far, keep it moderate. Push day: bench, OHP, lateral raises.

The fitness AI saw the food data. Not because the extensions talk to each other, but because both write to the same tree and enrichContext injects everything into every prompt. The tree is the shared memory.

The Tree Works While You Are Away

treeos
tabor@treeos.ai/Health intent
Last 24h: 2 executed
Compressed dormant branches under /Projects/Old
Nudged: "You said 3x/week running. No runs logged."
tabor@treeos.ai/Health intent reject 2
Got it. Won't nudge about running again.
tabor@treeos.ai/Health water
Hydration at /Health:
Cascade: 12 signals today, all succeeded
Codebook: 23 entries, compressed 2h ago
Memory: 34 connections to /Health/Food
Coherence: 0.91 against tree thesis
Evolution: active, 47 notes this week
tabor@treeos.ai/Health digest
This week: 12 workouts logged, protein averaging 134g,
sleep improving. Study queue untouched since Monday.

intent shows what the tree did on its own. water shows the full picture at any position. digest summarizes the week. The tree compresses, detects contradictions, tracks gaps, and nudges you. Review it. Reject what you do not want. It learns.

One Command to Start

treeos
tabor@treeos.ai~ life food fitness study recovery
Creating your Life tree...
Scaffolded: Food, Fitness, Study, Recovery
Each domain has its own AI, its own commands, its own dashboard.
tabor@treeos.ai/Life ls
Food Fitness Study Recovery
tabor@treeos.ai/Life life add kb
Added Knowledge Base to your Life tree.

life scaffolds a tree with the domains you want. Each domain sets up its own extension, modes, tools, and dashboards. Add more later with life add. The tree grows with you.

Get Started

terminal
# Install
npm install -g treeos
# Connect to a land
treeos connect https://treeos.ai
# Create your account
treeos register
# Start the shell
treeos start

Prefer a browser? TreeOS also has a web interface. Same tree, same data, rendered as HTML pages. Manage your land, browse trees, and interact with AI from the browser.