# Treehouse

> Treehouse is a shared file workspace for people and their agents. Everything is a plain file: people use it through the web app and a synced folder on their computer, agents through the same folder, an MCP server or a REST API.

Canonical Origin: https://trytree.house

If you are an agent working in a Treehouse workspace, start with the agent handbook: https://trytree.house/docs/agents/handbook.md

- MCP server: https://api.trytree.house/api/mcp (Streamable HTTP). Authenticate with an `x-api-key: <key>` header. People create keys in the web app from the account menu, under API keys.
- REST API: https://api.trytree.house/api/workspaces/{workspaceId}/... with the same `x-api-key` header.
- Read AGENTS.md at the workspace root before doing anything else, if it exists.
- Every file has a version. Pass the version you read when you write, so a concurrent edit becomes a conflicted copy instead of being lost.
- Every docs page is available as markdown by adding `.md` to its URL.
- The Treehouse agent skill: https://trytree.house/.well-known/agent-skills/treehouse/SKILL.md

## Agents

- [Agents](https://trytree.house/docs/agents.md): Everything an agent needs to work in a Treehouse workspace, and everything you need to connect one.
- [Connect an agent](https://trytree.house/docs/agents/connect.md): Give Claude Code, Codex, Cursor or any other agent access to a workspace, with its own key when you want its work labelled.
- [How agents work with Treehouse](https://trytree.house/docs/agents/connect/how-agents-work.md): The two ways an agent can reach a workspace, what it can do there, and how its work shows up for everyone else.
- [Connect Claude Code](https://trytree.house/docs/agents/connect/claude-code.md): Give Claude Code access to a workspace through your synced folder, the Treehouse MCP server, or both.
- [Connect other agents](https://trytree.house/docs/agents/connect/other-agents.md): Connection settings for Cursor, VS Code, Codex, Gemini CLI, Claude Desktop and any other MCP client.
- [Manage API keys](https://trytree.house/docs/agents/connect/api-keys.md): Create a key for each agent, see which keys can reach your workspaces, and revoke the ones you no longer need.
- [Agent handbook](https://trytree.house/docs/agents/handbook.md): Written for agents. How to reach a Treehouse workspace, the rules that keep everyone's work safe, and the conventions the web app understands.
- [Versions and conflicts](https://trytree.house/docs/agents/handbook/versions-and-conflicts.md): The concurrency contract every Treehouse client shares - version numbers, compare-and-swap writes, conflicted copies, deletes, moves and restores.
- [API reference](https://trytree.house/docs/agents/reference.md): The protocol reference - authentication, every MCP tool, the REST API and the change feed.
- [Authentication](https://trytree.house/docs/agents/reference/authentication.md): How API keys work, what each kind of key can reach, the device authorisation flow the CLI and desktop app use, and how keys are revoked.
- [MCP server](https://trytree.house/docs/agents/reference/mcp-server.md): Every tool the Treehouse MCP server exposes, with parameters, outputs, limits and the instructions it gives connected agents.
- [REST API](https://trytree.house/docs/agents/reference/rest-api.md): Endpoints for reading, writing, moving, searching, sharing and commenting on workspace files over HTTP, with headers, status codes and examples.
- [Change feed](https://trytree.house/docs/agents/reference/change-feed.md): Read every change to a workspace in order with a cursor, so a script or agent can react to new and edited files.

## Get started

- [Get started](https://trytree.house/docs/get-started.md): What Treehouse is, how to set up your first workspace, and how it works underneath.
- [What is Treehouse?](https://trytree.house/docs/get-started/what-is-treehouse.md): A shared workspace of plain files that people and agents both work in, with the sharing, history and review that plain folders lack.
- [Quickstart](https://trytree.house/docs/get-started/quickstart.md): Create a workspace, sync it to your computer, connect an agent and let it set things up. About ten minutes.
- [How Treehouse works](https://trytree.house/docs/get-started/how-treehouse-works.md): Workspaces, versions, conflicted copies and attribution - the handful of ideas the rest of Treehouse is built on.
- [Set up a workspace with an agent](https://trytree.house/docs/get-started/set-up-with-an-agent.md): Hand a new, empty workspace to an agent. It interviews you, proposes a structure and builds it once you agree.

## Files and folders

- [Files and folders](https://trytree.house/docs/files.md): Find, read, write, upload and organise the files in a workspace, and get back anything that changed.
- [Find and view files](https://trytree.house/docs/files/view-files.md): Browse the file tree, search by name, and see how Treehouse shows markdown, HTML, code, images and everything else.
- [Create and edit files](https://trytree.house/docs/files/create-and-edit.md): Make new files and folders in the web app, edit markdown, code and HTML, and save your changes.
- [Upload and download files](https://trytree.house/docs/files/upload-and-download.md): Add files from your computer to a workspace, decide what happens when names clash, and download a copy of any file.
- [Rename, move and organise files](https://trytree.house/docs/files/organise-files.md): Rename, move, reorder and delete files and folders, and give them icons, from the sidebar tree.
- [Turn a folder into a page or calendar](https://trytree.house/docs/files/folder-pages.md): Give a folder a front page with a README, or show a folder of dated notes as a calendar you can reschedule by dragging.
- [Front matter reference](https://trytree.house/docs/files/front-matter.md): The YAML block at the top of a markdown file, and the keys Treehouse reads from it to label, title and schedule your files.
- [Publish an HTML page](https://trytree.house/docs/files/html-pages.md): Show HTML files as full pages, decide when their scripts may run, and share them publicly as reports, dashboards or decks.
- [See and restore earlier versions](https://trytree.house/docs/files/version-history.md): Look through every change to a file, see who made it, view or restore an older version, and catch up on what changed while you were away.
- [Conflicted copies](https://trytree.house/docs/files/conflicted-copies.md): When two edits to the same file collide, Treehouse keeps both. Here's what a conflicted copy is, how to spot one and how to resolve it.
- [Keep files private](https://trytree.house/docs/files/private-files.md): Make a file or folder visible only to you and your own agents, even in a workspace you share with others.

## Share and collaborate

- [Share and collaborate](https://trytree.house/docs/sharing.md): Invite people into a workspace, share files with anyone by link, comment on documents and see who changed what.
- [Invite people to a workspace](https://trytree.house/docs/sharing/invite-people.md): Bring teammates into a workspace with an invite link, see who's a member, and remove people when they no longer need access.
- [Share a file or folder with a link](https://trytree.house/docs/sharing/share-links.md): Send members straight to a file, or give anyone read-only access to a file or folder, with an optional password and a pinned version.
- [Comment on a document](https://trytree.house/docs/sharing/comments.md): Leave comments on passages of a markdown file, reply and resolve threads, and let agents read and act on your feedback.
- [See what changed in a workspace](https://trytree.house/docs/sharing/activity.md): The activity feed shows every change and comment in a workspace, who made it, and whether it came from a person or an agent.
- [Customise your workspace](https://trytree.house/docs/sharing/customise-your-workspace.md): Rename a workspace, give it an icon and colour, create new workspaces, and choose a theme for everyone or just for you.

## Desktop app and sync

- [Desktop app and sync](https://trytree.house/docs/desktop.md): Keep a folder on your computer in step with a workspace, using the Mac app or the sync CLI.
- [Install the desktop app](https://trytree.house/docs/desktop/install-the-desktop-app.md): Download Treehouse for Mac, sign in and pick a folder, and your workspace's files appear on your computer and stay in sync.
- [How sync works](https://trytree.house/docs/desktop/how-sync-works.md): What the sync engine does in the background, which files it skips, and how it protects your work when things go wrong.
- [Manage synced folders](https://trytree.house/docs/desktop/manage-synced-folders.md): Check sync status, pause, move or stop syncing a folder, add another workspace, and sign out, all from the Treehouse icon in your menu bar.
- [Sync a folder with the CLI](https://trytree.house/docs/desktop/sync-with-the-cli.md): Install the treehouse command-line tool to sync a folder on Windows, Linux, a server or any machine where the desktop app doesn't run.
- [Sync CLI reference](https://trytree.house/docs/desktop/cli-reference.md): Every treehouse command and flag, the files and environment variables the CLI reads, and the safety rules it follows while syncing.

## Playbooks

- [Playbooks](https://trytree.house/docs/playbooks.md): Opinionated patterns for running a workspace with your agents, from the rulebook they follow to the routines that keep it alive.
- [Write your AGENTS.md](https://trytree.house/docs/playbooks/write-your-agents-md.md): The one file every agent reads first. What to put in it so any agent, in any session, works the way your team does.
- [Shape your workspace](https://trytree.house/docs/playbooks/shape-your-workspace.md): Folder structures that work for people and agents alike, and the handful of habits that keep a workspace easy to navigate as it grows.
- [Run an inbox your agent files](https://trytree.house/docs/playbooks/inbox-and-filing.md): Drop anything into Inbox/ without deciding where it goes, and have an agent file it by rules you write once.
- [Review your agent's work](https://trytree.house/docs/playbooks/review-loop.md): Let an agent draft, review it with comments in the web app, and have the agent work through your feedback thread by thread.
- [Give your agents a memory](https://trytree.house/docs/playbooks/memory-and-decisions.md): Status pages, decision records and handoff notes that let any agent pick up where the last session left off.
- [Set up routines](https://trytree.house/docs/playbooks/routines.md): Recurring agent work, like a morning inbox run or a weekly review, and where the schedule lives when Treehouse doesn't run agents itself.
- [Work with several agents](https://trytree.house/docs/playbooks/multiple-agents.md): Give each agent its own key and its own lane, hand work over through files, and let versioning catch the collisions.
- [Run client work](https://trytree.house/docs/playbooks/client-work.md): A folder per client, agents that prepare the deliverables, and share links that give clients exactly what they should see.
- [Build a second brain](https://trytree.house/docs/playbooks/second-brain.md): A personal workspace where you capture everything quickly and an agent keeps it filed, linked and useful.

## Account and billing

- [Account and billing](https://trytree.house/docs/account.md): What each plan includes, how billing and seats work, managing your account, and how Treehouse keeps your files safe.
- [Plans and limits](https://trytree.house/docs/account/plans-and-limits.md): What Seedling, Grove and Forest include, how usage is counted, and what happens when a workspace reaches a limit.
- [Upgrade and manage billing](https://trytree.house/docs/account/billing.md): Move a workspace onto Grove or Forest, understand how seats are charged, and what happens if a payment fails or you cancel.
- [Manage your account](https://trytree.house/docs/account/your-account.md): Create an account, sign in and out, reset a forgotten password, and move between the workspaces you belong to.
- [Security and privacy](https://trytree.house/docs/account/security-and-privacy.md): How Treehouse encrypts your files, who can see what in a workspace, and how keys, share links and HTML pages are kept in check.

## Help

- [Help](https://trytree.house/docs/help.md): Fixes for common problems, answers to common questions, and the words Treehouse uses.
- [Troubleshooting](https://trytree.house/docs/help/troubleshooting.md): The problems people hit most often with sync, agent connections, sharing and limits, and how to fix each one.
- [Frequently asked questions](https://trytree.house/docs/help/faq.md): Short answers to the questions people ask most about Treehouse, agents, sharing and data.
- [Glossary](https://trytree.house/docs/help/glossary.md): The words Treehouse uses, and what each one means in the app and in these docs.

## Self-host Treehouse

- [Self-host Treehouse](https://trytree.house/docs/self-hosting.md): Run your own Treehouse server - the architecture, required and optional environment variables, storage and encryption, and connecting clients.

## Resources

- [Docs home](https://trytree.house/docs): The Treehouse documentation, organised by task.
- [Full docs](https://trytree.house/llms-docs.txt): Every public docs page in full, as markdown, in one file.