[{"data":1,"prerenderedAt":1259},["ShallowReactive",2],{"docs.index":3,"docs.page.\u002Fdocs\u002Fagents\u002Fconnect\u002Fset-up-a-workspace":417},[4,20,26,34,44,53,62,69,76,82,87,92,101,108,114,119,123,130,134,138,142,149,154,158,165,170,175,184,190,196,202,208,215,219,228,233,239,247,252,258,265,271,277,282,286,290,295,301,306,311,315,319,324,330,336,341,345,352,357,363,368,372,376,380,386,391,396,401,405,411],{"path":5,"title":6,"navTitle":7,"seoTitle":8,"description":9,"type":10,"position":11,"updated":12,"release":13,"related":14,"plans":17},"\u002Fdocs\u002Faccount\u002Fbilling","Upgrade and manage billing","Billing",null,"Move a workspace onto Grove or Forest, understand how seats are charged, and what happens if a payment fails or you cancel.","how-to",2,"2026-09-29","public",[15,16],"\u002Fdocs\u002Faccount\u002Fplans-and-limits","\u002Fdocs\u002Fsharing\u002Finvite-people",[18,19],"grove","forest",{"path":21,"title":22,"navTitle":8,"seoTitle":8,"description":23,"type":24,"position":25,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Faccount","Account and billing","What each plan includes, how billing and seats work, managing your account, and how Treehouse keeps your files safe.","hub",7,{"path":15,"title":27,"navTitle":8,"seoTitle":8,"description":28,"type":29,"position":30,"updated":31,"release":13,"related":32,"plans":8},"Plans and limits","What Seedling, Grove and Forest include, how usage is counted, and what happens when a workspace reaches a limit.","reference",1,"2026-10-29",[5,16,33],"\u002Fdocs\u002Fsharing\u002Fshare-links",{"path":35,"title":36,"navTitle":8,"seoTitle":8,"description":37,"type":38,"position":39,"updated":31,"release":13,"related":40,"plans":8},"\u002Fdocs\u002Faccount\u002Fsecurity-and-privacy","Security and privacy","How Treehouse encrypts your files, who can see what in a workspace, and how keys, share links and HTML pages are kept in check.","concept",4,[41,33,42,43],"\u002Fdocs\u002Fagents\u002Fconnect\u002Fapi-keys","\u002Fdocs\u002Ffiles\u002Fprivate-files","\u002Fdocs\u002Ffiles\u002Fhtml-pages",{"path":45,"title":46,"navTitle":47,"seoTitle":8,"description":48,"type":10,"position":49,"updated":12,"release":13,"related":50,"plans":8},"\u002Fdocs\u002Faccount\u002Fyour-account","Manage your account","Your account","Create an account, sign in and out, reset a forgotten password, and move between the workspaces you belong to.",3,[51,52,35],"\u002Fdocs\u002Fget-started\u002Fquickstart","\u002Fdocs\u002Fsharing\u002Fcustomise-your-workspace",{"path":41,"title":54,"navTitle":55,"seoTitle":8,"description":56,"type":10,"position":57,"updated":31,"release":13,"related":58,"plans":8},"Manage API keys","API keys","Create a key for the sync CLI or an agent that can't sign in through a browser, see what each key can reach, and revoke the ones you no longer need.",6,[59,60,61,35],"\u002Fdocs\u002Fagents\u002Fconnect\u002Fconnected-agents","\u002Fdocs\u002Fagents\u002Fconnect\u002Fclaude-code","\u002Fdocs\u002Fagents\u002Freference\u002Fauthentication",{"path":60,"title":63,"navTitle":8,"seoTitle":8,"description":64,"type":10,"position":49,"updated":65,"release":13,"related":66,"plans":8},"Connect Claude Code","Give Claude Code access to a workspace through your synced folder, the Treehouse MCP server, or both.","2026-10-30",[67,59,41,68],"\u002Fdocs\u002Fagents\u002Fconnect\u002Fhow-agents-work","\u002Fdocs\u002Fplaybooks\u002Fwrite-your-agents-md",{"path":59,"title":70,"navTitle":71,"seoTitle":8,"description":72,"type":10,"position":73,"updated":31,"release":13,"related":74,"plans":8},"Manage connected agents","Connected agents","See which agents have signed in to Treehouse as you, rename how their work is labelled, and disconnect the ones you no longer use.",5,[60,75,41],"\u002Fdocs\u002Fagents\u002Fconnect\u002Fother-agents",{"path":67,"title":77,"navTitle":78,"seoTitle":8,"description":79,"type":38,"position":30,"updated":31,"release":13,"related":80,"plans":8},"How agents work with Treehouse","How agents work","The two ways an agent can reach a workspace, what it can do there, and how its work shows up for everyone else.",[60,59,41,81],"\u002Fdocs\u002Fagents\u002Fhandbook",{"path":83,"title":84,"navTitle":85,"seoTitle":8,"description":86,"type":24,"position":30,"updated":31,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fagents\u002Fconnect","Connect an agent","Connect","Give Claude Code, Codex, Cursor or any other agent access to a workspace, signed in through your browser and labelled with a name you choose.",{"path":75,"title":88,"navTitle":8,"seoTitle":8,"description":89,"type":10,"position":39,"updated":31,"release":13,"related":90,"plans":8},"Connect other agents","Connect Cursor, VS Code, Codex, Gemini CLI, Claude Desktop, claude.ai, ChatGPT or any other MCP client by signing in, or with an API key.",[60,59,41,91],"\u002Fdocs\u002Fagents\u002Freference\u002Fmcp-server",{"path":93,"title":94,"navTitle":95,"seoTitle":96,"description":97,"type":10,"position":11,"updated":31,"release":13,"related":98,"plans":8},"\u002Fdocs\u002Fagents\u002Fconnect\u002Fset-up-a-workspace","Set up a new workspace for someone","Set up a new workspace","Agent guide: set up a new Treehouse workspace","Written for agents. Connect a person's new workspace to their computer, doing as much of the work yourself as you can, then help them organise it.",[99,81,100],"\u002Fdocs\u002Fget-started\u002Fset-up-with-an-agent","\u002Fdocs\u002Fdesktop\u002Fsync-with-the-cli",{"path":81,"title":102,"navTitle":102,"seoTitle":103,"description":104,"type":24,"position":11,"updated":65,"release":13,"related":105,"plans":8},"Agent handbook","Agent handbook: how agents work in Treehouse","Written for agents. How to reach a Treehouse workspace, the rules that keep everyone's work safe, and the conventions the web app understands.",[91,106,107],"\u002Fdocs\u002Fagents\u002Fhandbook\u002Fversions-and-conflicts","\u002Fdocs\u002Fplaybooks\u002Freview-loop",{"path":106,"title":109,"navTitle":8,"seoTitle":8,"description":110,"type":38,"position":30,"updated":31,"release":13,"related":111,"plans":8},"Versions and conflicts","The concurrency contract every Treehouse client shares - version numbers, compare-and-swap writes, conflicted copies, deletes, moves and restores.",[112,113,91],"\u002Fdocs\u002Ffiles\u002Fconflicted-copies","\u002Fdocs\u002Fagents\u002Freference\u002Frest-api",{"path":115,"title":116,"navTitle":8,"seoTitle":117,"description":118,"type":24,"position":30,"updated":31,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fagents","Agents","Treehouse for agents","Everything an agent needs to work in a Treehouse workspace, and everything you need to connect one.",{"path":61,"title":120,"navTitle":8,"seoTitle":8,"description":121,"type":29,"position":30,"updated":31,"release":13,"related":122,"plans":8},"Authentication","How OAuth sign-in for MCP clients and API keys work, what each credential can reach, the device flow the CLI uses, and how access is revoked.",[59,41,91,113],{"path":124,"title":125,"navTitle":8,"seoTitle":8,"description":126,"type":29,"position":39,"updated":31,"release":13,"related":127,"plans":8},"\u002Fdocs\u002Fagents\u002Freference\u002Fchange-feed","Change feed","Read every change to a workspace in order with a cursor, so a script or agent can react to new and edited files.",[128,129,106],"\u002Fdocs\u002Fsharing\u002Factivity","\u002Fdocs\u002Fplaybooks\u002Froutines",{"path":131,"title":132,"navTitle":8,"seoTitle":8,"description":133,"type":24,"position":49,"updated":31,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fagents\u002Freference","API reference","The protocol reference - authentication, every MCP tool, the REST API and the change feed.",{"path":91,"title":135,"navTitle":8,"seoTitle":8,"description":136,"type":29,"position":11,"updated":65,"release":13,"related":137,"plans":8},"MCP server","Every tool the Treehouse MCP server exposes, with parameters, outputs, limits and the instructions it gives connected agents.",[60,75,106],{"path":113,"title":139,"navTitle":8,"seoTitle":8,"description":140,"type":29,"position":49,"updated":65,"release":13,"related":141,"plans":8},"REST API","Endpoints for reading, writing, moving, searching, sharing and commenting on workspace files over HTTP, with headers, status codes and examples.",[61,106,124],{"path":143,"title":144,"navTitle":145,"seoTitle":8,"description":146,"type":29,"position":73,"updated":65,"release":13,"related":147,"plans":8},"\u002Fdocs\u002Fdesktop\u002Fcli-reference","Sync CLI reference","Sync CLI","Every treehouse command and flag, the files and environment variables the CLI reads, and the safety rules it follows while syncing.",[100,148,124],"\u002Fdocs\u002Fdesktop\u002Fhow-sync-works",{"path":148,"title":150,"navTitle":8,"seoTitle":8,"description":151,"type":38,"position":11,"updated":65,"release":13,"related":152,"plans":8},"How sync works","What the sync engine does in the background, which files it skips, and how it protects your work when things go wrong.",[112,42,128,153],"\u002Fdocs\u002Fget-started\u002Fhow-treehouse-works",{"path":155,"title":156,"navTitle":8,"seoTitle":8,"description":157,"type":24,"position":73,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fdesktop","Desktop app and sync","Keep a folder on your computer in step with a workspace, using the Mac app or the sync CLI.",{"path":159,"title":160,"navTitle":8,"seoTitle":8,"description":161,"type":10,"position":30,"updated":162,"release":13,"related":163,"plans":8},"\u002Fdocs\u002Fdesktop\u002Finstall-the-desktop-app","Install the desktop app","Download Treehouse for Mac, sign in and pick a folder, and your workspace's files appear on your computer and stay in sync.","2026-10-12",[148,164,100],"\u002Fdocs\u002Fdesktop\u002Fmanage-synced-folders",{"path":164,"title":166,"navTitle":8,"seoTitle":8,"description":167,"type":10,"position":49,"updated":162,"release":13,"related":168,"plans":8},"Manage synced folders","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.",[148,100,169],"\u002Fdocs\u002Fhelp\u002Ftroubleshooting",{"path":100,"title":171,"navTitle":172,"seoTitle":8,"description":173,"type":10,"position":39,"updated":31,"release":13,"related":174,"plans":8},"Sync a folder with the CLI","Sync with the CLI","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.",[143,148,164],{"path":176,"title":177,"navTitle":178,"seoTitle":8,"description":179,"type":10,"position":57,"updated":180,"release":13,"related":181,"plans":8},"\u002Fdocs\u002Ffiles\u002Fboards","Track work on a board","Boards","Show a folder of markdown files as coloured columns of cards, and move work along by dragging a card or changing one line of front matter.","2026-09-30",[182,183,68],"\u002Fdocs\u002Ffiles\u002Ffolder-pages","\u002Fdocs\u002Ffiles\u002Ffront-matter",{"path":112,"title":185,"navTitle":8,"seoTitle":8,"description":186,"type":38,"position":187,"updated":12,"release":13,"related":188,"plans":8},"Conflicted copies","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.",13,[189,148,106],"\u002Fdocs\u002Ffiles\u002Fversion-history",{"path":191,"title":192,"navTitle":193,"seoTitle":8,"description":194,"type":10,"position":11,"updated":12,"release":13,"related":195,"plans":8},"\u002Fdocs\u002Ffiles\u002Fcreate-and-edit","Create and edit files","Create and edit","Make new files and folders in the web app, edit markdown, code and HTML, and save your changes.",[183,112,189],{"path":182,"title":197,"navTitle":198,"seoTitle":8,"description":199,"type":10,"position":73,"updated":180,"release":13,"related":200,"plans":8},"Turn a folder into a page or calendar","Folder pages and calendars","Give a folder a front page with a README, or show a folder of dated notes as a calendar you can reschedule by dragging.",[176,183,43,201],"\u002Fdocs\u002Fplaybooks\u002Fshape-your-workspace",{"path":183,"title":203,"navTitle":204,"seoTitle":8,"description":205,"type":29,"position":25,"updated":65,"release":13,"related":206,"plans":8},"Front matter reference","Front matter","The YAML block at the top of a markdown file, and the keys Treehouse reads from it to label, title, schedule and track your files.",[182,176,191,207,129],"\u002Fdocs\u002Ffiles\u002Ftag-notes",{"path":43,"title":209,"navTitle":210,"seoTitle":8,"description":211,"type":10,"position":212,"updated":12,"release":13,"related":213,"plans":8},"Publish an HTML page","HTML pages","Show HTML files as full pages, decide when their scripts may run, and share them publicly as reports, dashboards or decks.",8,[33,182,214],"\u002Fdocs\u002Ffiles\u002Fview-files",{"path":216,"title":217,"navTitle":8,"seoTitle":8,"description":218,"type":24,"position":49,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Ffiles","Files and folders","Find, read, write, upload and organise the files in a workspace, and get back anything that changed.",{"path":220,"title":221,"navTitle":222,"seoTitle":8,"description":223,"type":10,"position":224,"updated":65,"release":13,"related":225,"plans":8},"\u002Fdocs\u002Ffiles\u002Flink-notes","Link notes together","Link notes","Connect notes with wikilinks, see which notes link to a file, and keep those links working when you rename it.",15,[226,42,227,91],"\u002Fdocs\u002Ffiles\u002Forganise-files","\u002Fdocs\u002Fplaybooks\u002Fsecond-brain",{"path":226,"title":229,"navTitle":230,"seoTitle":8,"description":231,"type":10,"position":39,"updated":31,"release":13,"related":232,"plans":8},"Rename, move and organise files","Organise files","Rename, move, reorder and delete files and folders, and give them icons, from the sidebar tree.",[189,42,201,220],{"path":42,"title":234,"navTitle":235,"seoTitle":8,"description":236,"type":10,"position":237,"updated":65,"release":13,"related":238,"plans":8},"Keep files private","Private files","Make a file or folder visible only to you and your own agents, even in a workspace you share with others.",14,[226,33,67],{"path":240,"title":241,"navTitle":242,"seoTitle":8,"description":243,"type":10,"position":244,"updated":31,"release":13,"related":245,"plans":8},"\u002Fdocs\u002Ffiles\u002Frestore-to-an-earlier-time","Restore a folder or workspace to an earlier time","Restore to an earlier time","Put a folder, or the whole workspace, back the way it was at a moment you choose, after seeing every change it will make.",11,[246,189,128],"\u002Fdocs\u002Ffiles\u002Ftrash",{"path":207,"title":248,"navTitle":248,"seoTitle":8,"description":249,"type":10,"position":250,"updated":65,"release":13,"related":251,"plans":8},"Tag notes","Label notes with tags in their front matter or text, and find every note with a tag from the sidebar search.",16,[183,220,42,91],{"path":246,"title":253,"navTitle":254,"seoTitle":8,"description":255,"type":10,"position":256,"updated":31,"release":13,"related":257,"plans":8},"Bring back deleted files","Trash","Every file deleted from a workspace, by a person or an agent, waits in the trash with the content it had, so you can bring it back.",10,[189,128,42],{"path":259,"title":260,"navTitle":261,"seoTitle":8,"description":262,"type":10,"position":263,"updated":31,"release":13,"related":264,"plans":8},"\u002Fdocs\u002Ffiles\u002Fundo-an-agent","Undo what an agent did","Undo an agent","Reverse everything one agent or API key changed since a moment you choose, while keeping every change anyone else made.",12,[240,128,41],{"path":266,"title":267,"navTitle":268,"seoTitle":8,"description":269,"type":10,"position":49,"updated":12,"release":13,"related":270,"plans":8},"\u002Fdocs\u002Ffiles\u002Fupload-and-download","Upload and download files","Upload and download","Add files from your computer to a workspace, decide what happens when names clash, and download a copy of any file.",[191,148,15],{"path":189,"title":272,"navTitle":273,"seoTitle":8,"description":274,"type":10,"position":275,"updated":31,"release":13,"related":276,"plans":8},"See and restore earlier versions","Version history","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.",9,[246,112,128,106],{"path":214,"title":278,"navTitle":279,"seoTitle":8,"description":280,"type":10,"position":30,"updated":31,"release":13,"related":281,"plans":8},"Find and view files","Find and view","Browse the file tree, search by name, and see how Treehouse shows markdown, HTML, code, images, video, audio and everything else.",[191,182,189],{"path":153,"title":283,"navTitle":8,"seoTitle":8,"description":284,"type":38,"position":49,"updated":31,"release":13,"related":285,"plans":8},"How Treehouse works","Workspaces, versions, conflicted copies and attribution - the handful of ideas the rest of Treehouse is built on.",[189,112,67,106],{"path":287,"title":288,"navTitle":8,"seoTitle":8,"description":289,"type":24,"position":11,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fget-started","Get started","What Treehouse is, how to set up your first workspace, and how it works underneath.",{"path":51,"title":291,"navTitle":8,"seoTitle":8,"description":292,"type":293,"position":11,"updated":31,"release":13,"related":294,"plans":8},"Quickstart","Create a workspace, sync it to your computer, connect an agent and let it set things up. About ten minutes.","guide",[99,60,68],{"path":99,"title":296,"navTitle":297,"seoTitle":8,"description":298,"type":10,"position":39,"updated":31,"release":13,"related":299,"plans":8},"Set up a workspace with an agent","Set up with an agent","Hand a new, empty workspace to an agent. It interviews you, proposes a structure and builds it once you agree.",[201,68,300],"\u002Fdocs\u002Fplaybooks\u002Finbox-and-filing",{"path":302,"title":303,"navTitle":303,"seoTitle":8,"description":304,"type":38,"position":30,"updated":12,"release":13,"related":305,"plans":8},"\u002Fdocs\u002Fget-started\u002Fwhat-is-treehouse","What is Treehouse?","A shared workspace of plain files that people and agents both work in, with the sharing, history and review that plain folders lack.",[51,153,67],{"path":307,"title":308,"navTitle":309,"seoTitle":8,"description":310,"type":29,"position":11,"updated":31,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fhelp\u002Ffaq","Frequently asked questions","FAQ","Short answers to the questions people ask most about Treehouse, agents, sharing and data.",{"path":312,"title":313,"navTitle":8,"seoTitle":8,"description":314,"type":29,"position":49,"updated":31,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fhelp\u002Fglossary","Glossary","The words Treehouse uses, and what each one means in the app and in these docs.",{"path":316,"title":317,"navTitle":8,"seoTitle":8,"description":318,"type":24,"position":212,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fhelp","Help","Fixes for common problems, answers to common questions, and the words Treehouse uses.",{"path":169,"title":320,"navTitle":8,"seoTitle":321,"description":322,"type":10,"position":30,"updated":31,"release":13,"related":323,"plans":8},"Troubleshooting","Troubleshooting Treehouse sync, agents and sharing","The problems people hit most often with sync, agent connections, sharing and limits, and how to fix each one.",[164,60,112],{"path":325,"title":326,"navTitle":8,"seoTitle":327,"description":328,"type":24,"position":329,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs","Treehouse docs","Treehouse documentation","How to set up a shared workspace for your team and your agents, and how to get the most out of it once you have.",0,{"path":331,"title":332,"navTitle":333,"seoTitle":8,"description":334,"type":293,"position":212,"updated":12,"release":13,"related":335,"plans":8},"\u002Fdocs\u002Fplaybooks\u002Fclient-work","Run client work","Client work","A folder per client, agents that prepare the deliverables, and share links that give clients exactly what they should see.",[33,43,107],{"path":300,"title":337,"navTitle":338,"seoTitle":8,"description":339,"type":293,"position":49,"updated":12,"release":13,"related":340,"plans":8},"Run an inbox your agent files","Inbox and filing","Drop anything into Inbox\u002F without deciding where it goes, and have an agent file it by rules you write once.",[129,227,201],{"path":342,"title":343,"navTitle":8,"seoTitle":8,"description":344,"type":24,"position":57,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fplaybooks","Playbooks","Opinionated patterns for running a workspace with your agents, from the rulebook they follow to the routines that keep it alive.",{"path":346,"title":347,"navTitle":348,"seoTitle":8,"description":349,"type":293,"position":73,"updated":31,"release":13,"related":350,"plans":8},"\u002Fdocs\u002Fplaybooks\u002Fmemory-and-decisions","Give your agents a memory","Memory and decisions","Status pages, decision records and handoff notes that let any agent pick up where the last session left off.",[68,351,182],"\u002Fdocs\u002Fplaybooks\u002Fmultiple-agents",{"path":351,"title":353,"navTitle":354,"seoTitle":8,"description":355,"type":293,"position":25,"updated":31,"release":13,"related":356,"plans":8},"Work with several agents","Several agents","Give each agent its own key and its own lane, hand work over through files, and let versioning catch the collisions.",[41,346,112],{"path":107,"title":358,"navTitle":359,"seoTitle":8,"description":360,"type":293,"position":39,"updated":12,"release":13,"related":361,"plans":8},"Review your agent's work","Review loop","Let an agent draft, review it with comments in the web app, and have the agent work through your feedback thread by thread.",[362,189,60],"\u002Fdocs\u002Fsharing\u002Fcomments",{"path":129,"title":364,"navTitle":365,"seoTitle":8,"description":366,"type":293,"position":57,"updated":31,"release":13,"related":367,"plans":8},"Set up routines","Routines","Recurring agent work, like a morning inbox run or a weekly review, and where the schedule lives when Treehouse doesn't run agents itself.",[300,100,124],{"path":227,"title":369,"navTitle":8,"seoTitle":8,"description":370,"type":293,"position":275,"updated":65,"release":13,"related":371,"plans":8},"Build a second brain","A personal workspace where you capture everything quickly and an agent keeps it filed, linked and useful.",[300,129,182],{"path":201,"title":373,"navTitle":8,"seoTitle":8,"description":374,"type":293,"position":11,"updated":31,"release":13,"related":375,"plans":8},"Shape your workspace","Folder structures that work for people and agents alike, and the handful of habits that keep a workspace easy to navigate as it grows.",[68,182,226],{"path":68,"title":377,"navTitle":8,"seoTitle":8,"description":378,"type":293,"position":30,"updated":180,"release":13,"related":379,"plans":8},"Write your AGENTS.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.",[201,67,99],{"path":381,"title":382,"navTitle":383,"seoTitle":8,"description":384,"type":24,"position":275,"updated":31,"release":13,"related":385,"plans":8},"\u002Fdocs\u002Fself-hosting","Self-host Treehouse","Self-hosting","Run your own Treehouse server - the architecture, required and optional environment variables, storage and encryption, and connecting clients.",[61,91,143],{"path":128,"title":387,"navTitle":388,"seoTitle":8,"description":389,"type":10,"position":39,"updated":31,"release":13,"related":390,"plans":8},"See what changed in a workspace","Activity","The activity feed shows every change and comment in a workspace, who made it, and whether it came from a person or an agent.",[67,59,41,189,112],{"path":362,"title":392,"navTitle":393,"seoTitle":8,"description":394,"type":10,"position":49,"updated":12,"release":13,"related":395,"plans":8},"Comment on a document","Comments","Leave comments on passages of a markdown file, reply and resolve threads, and let agents read and act on your feedback.",[107,189,128],{"path":52,"title":397,"navTitle":398,"seoTitle":8,"description":399,"type":10,"position":73,"updated":12,"release":13,"related":400,"plans":8},"Customise your workspace","Customise a workspace","Rename a workspace, give it an icon and colour, create new workspaces, and choose a theme for everyone or just for you.",[15,33],{"path":402,"title":403,"navTitle":8,"seoTitle":8,"description":404,"type":24,"position":39,"updated":12,"release":13,"related":8,"plans":8},"\u002Fdocs\u002Fsharing","Share and collaborate","Invite people into a workspace, share files with anyone by link, comment on documents and see who changed what.",{"path":16,"title":406,"navTitle":407,"seoTitle":8,"description":408,"type":10,"position":30,"updated":31,"release":13,"related":409,"plans":410},"Invite people to a workspace","Invite people","Bring teammates into a workspace with an invite link, see who's a member, and remove people when they no longer need access.",[33,5,41],[18,19],{"path":33,"title":412,"navTitle":413,"seoTitle":8,"description":414,"type":10,"position":11,"updated":415,"release":13,"related":416,"plans":8},"Share a file or folder with a link","Share links","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.","2026-10-20",[16,43,189,15],{"id":418,"title":94,"body":419,"description":97,"extension":1252,"meta":1253,"navTitle":95,"navigation":1254,"path":93,"plans":8,"position":11,"related":1255,"release":13,"seo":1256,"seoTitle":96,"stem":1257,"type":10,"updated":31,"__hash__":1258},"docs\u002Fdocs\u002Fagents\u002Fconnect\u002Fset-up-a-workspace.md",{"type":420,"value":421,"toc":1233},"minimark",[422,436,441,444,448,451,530,544,548,553,586,590,593,637,656,660,663,677,795,801,934,943,947,950,953,1084,1094,1104,1108,1115,1118,1122,1128,1131,1134,1155,1169,1173,1191,1194,1198,1204,1208,1219,1223,1229],[423,424,427],"callout",{"title":425,"type":426},"This page is for you, the agent","agent",[428,429,430,431,435],"p",{},"Someone has just created a Treehouse workspace and asked you to set it up. Your job has two parts: get the workspace connected so you can work in its files, then organise it with them by following its ",[432,433,434],"code",{},"AGENTS.md",". Do as much as you can yourself. They should only have to answer questions, approve things and click where a person has to.",[437,438,440],"h2",{"id":439},"what-treehouse-is","What Treehouse is",[428,442,443],{},"Treehouse is a shared workspace of plain files: markdown, HTML, images, PDFs, anything. A person, their team and their agents all work in the same files. On a computer, the workspace is an ordinary folder that the Treehouse desktop app or CLI keeps in sync. On the web, the same files render as pages people can read, comment on and share. There's no special format and no integration to write: you work in it the way you work in any folder.",[437,445,447],{"id":446},"what-you-need-from-the-prompt","What you need from the prompt",[428,449,450],{},"The setup prompt you were given carries the facts for this workspace. Use them in every step below:",[452,453,454,467],"table",{},[455,456,457],"thead",{},[458,459,460,464],"tr",{},[461,462,463],"th",{},"Fact",[461,465,466],{},"Example",[468,469,470,481,491,501,511,520],"tbody",{},[458,471,472,476],{},[473,474,475],"td",{},"Workspace name",[473,477,478],{},[432,479,480],{},"Acme",[458,482,483,486],{},[473,484,485],{},"Workspace id",[473,487,488],{},[432,489,490],{},"ws_example",[458,492,493,496],{},[473,494,495],{},"Web app",[473,497,498],{},[432,499,500],{},"https:\u002F\u002Fapp.trytree.house",[458,502,503,506],{},[473,504,505],{},"API",[473,507,508],{},[432,509,510],{},"https:\u002F\u002Fapi.trytree.house",[458,512,513,515],{},[473,514,135],{},[473,516,517],{},[432,518,519],{},"https:\u002F\u002Fapi.trytree.house\u002Fapi\u002Fmcp",[458,521,522,525],{},[473,523,524],{},"Desktop app link",[473,526,527],{},[432,528,529],{},"treehouse:\u002F\u002Fopen?workspace=ws_example&origin=https:\u002F\u002Fapp.trytree.house",[428,531,532,533,536,537,539,540,543],{},"If the prompt's web app or API address isn't ",[432,534,535],{},"trytree.house",", the workspace is on a self-hosted server. Use the prompt's addresses wherever this page shows a ",[432,538,535],{}," one, and pass ",[432,541,542],{},"--api-base \u003CAPI>"," to the CLI.",[437,545,547],{"id":546},"steps","Steps",[549,550,552],"h3",{"id":551},"_1-work-out-how-you-can-reach-the-workspace","1. Work out how you can reach the workspace",[554,555,556,564,580],"ul",{},[557,558,559,563],"li",{},[560,561,562],"strong",{},"You can run commands on their computer"," (Claude Code, Codex, Cursor and similar): you can do nearly all of this yourself. Carry on with step 2.",[557,565,566,569,570,575,576,579],{},[560,567,568],{},"You can't install software, but can use MCP connectors"," (Claude Cowork, Claude Desktop, claude.ai, ChatGPT and similar): connect over MCP, as in ",[571,572,574],"a",{"href":573},"#connect-over-mcp-instead","connect over MCP instead",". Then skip to step 6. If they'd rather have the workspace as a folder on their computer too, suggest they ",[571,577,578],{"href":159},"install the desktop app"," afterwards.",[557,581,582,585],{},[560,583,584],{},"You have no files, commands or connectors",": you can't reach the workspace. Tell them, and suggest they open this prompt in an agent that can, such as Claude Code, Claude Cowork or Codex. Don't plan a structure they then have to build by hand.",[549,587,589],{"id":588},"_2-look-for-a-folder-thats-already-syncing","2. Look for a folder that's already syncing",[428,591,592],{},"The workspace may already be on this computer. Read the list of synced folders, which the desktop app and the CLI share:",[452,594,595,605],{},[455,596,597],{},[458,598,599,602],{},[461,600,601],{},"System",[461,603,604],{},"List of synced folders",[468,606,607,617,627],{},[458,608,609,612],{},[473,610,611],{},"macOS",[473,613,614],{},[432,615,616],{},"~\u002FLibrary\u002FApplication Support\u002FTreehouse\u002Flinks.json",[458,618,619,622],{},[473,620,621],{},"Linux",[473,623,624],{},[432,625,626],{},"~\u002F.config\u002Ftreehouse\u002Flinks.json",[458,628,629,632],{},[473,630,631],{},"Windows",[473,633,634],{},[432,635,636],{},"%APPDATA%\\Treehouse\\links.json",[428,638,639,640,643,644,647,648,651,652,655],{},"It holds ",[432,641,642],{},"{ \"links\": [{ \"root\": \"\u003Cfolder path>\", \"workspaceId\": \"\u003Cid>\" }] }",". If an entry's ",[432,645,646],{},"workspaceId"," matches the prompt's, its ",[432,649,650],{},"root"," is the workspace folder: go to step 4 to make sure it's actually syncing. An entry stays in the list while syncing is paused or signed out. If the CLI is installed, ",[432,653,654],{},"treehouse status"," shows the same list.",[549,657,659],{"id":658},"_3-otherwise-connect-a-folder","3. Otherwise, connect a folder",[428,661,662],{},"Tell them in a sentence what you're about to do and why (\"I'll install the Treehouse app so this workspace becomes a folder on your computer\"), and get a yes before installing anything. Then use the first option that fits.",[428,664,665,668,669,672,673,676],{},[560,666,667],{},"On a Mac with Apple silicon"," (",[432,670,671],{},"uname -m"," prints ",[432,674,675],{},"arm64","), use the desktop app. It's what they'll use day to day.",[678,679,680,766,782,785],"ol",{},[557,681,682,683,686,687],{},"Skip installing if ",[432,684,685],{},"\u002FApplications\u002FTreehouse.app"," already exists. Otherwise install it:",[688,689,694],"pre",{"className":690,"code":691,"language":692,"meta":693,"style":693},"language-bash shiki shiki-themes everforest-dark","curl -fsSL -o \u002Ftmp\u002FTreehouse.dmg https:\u002F\u002Fdl.trytree.house\u002Fdesktop\u002Flatest\u002FTreehouse-arm64.dmg\nhdiutil attach -nobrowse -quiet -mountpoint \u002Ftmp\u002Ftreehouse-dmg \u002Ftmp\u002FTreehouse.dmg\ncp -R \u002Ftmp\u002Ftreehouse-dmg\u002FTreehouse.app \u002FApplications\u002F\nhdiutil detach -quiet \u002Ftmp\u002Ftreehouse-dmg\n","bash","",[432,695,696,717,740,754],{"__ignoreMap":693},[697,698,700,704,708,711,714],"span",{"class":699,"line":30},"line",[697,701,703],{"class":702},"sRC7j","curl",[697,705,707],{"class":706},"sySyC"," -fsSL",[697,709,710],{"class":706}," -o",[697,712,713],{"class":706}," \u002Ftmp\u002FTreehouse.dmg",[697,715,716],{"class":706}," https:\u002F\u002Fdl.trytree.house\u002Fdesktop\u002Flatest\u002FTreehouse-arm64.dmg\n",[697,718,719,722,725,728,731,734,737],{"class":699,"line":11},[697,720,721],{"class":702},"hdiutil",[697,723,724],{"class":706}," attach",[697,726,727],{"class":706}," -nobrowse",[697,729,730],{"class":706}," -quiet",[697,732,733],{"class":706}," -mountpoint",[697,735,736],{"class":706}," \u002Ftmp\u002Ftreehouse-dmg",[697,738,739],{"class":706}," \u002Ftmp\u002FTreehouse.dmg\n",[697,741,742,745,748,751],{"class":699,"line":49},[697,743,744],{"class":702},"cp",[697,746,747],{"class":706}," -R",[697,749,750],{"class":706}," \u002Ftmp\u002Ftreehouse-dmg\u002FTreehouse.app",[697,752,753],{"class":706}," \u002FApplications\u002F\n",[697,755,756,758,761,763],{"class":699,"line":39},[697,757,721],{"class":702},[697,759,760],{"class":706}," detach",[697,762,730],{"class":706},[697,764,765],{"class":706}," \u002Ftmp\u002Ftreehouse-dmg\n",[557,767,768,769],{},"Open the prompt's desktop app link. The app opens straight at this workspace:",[688,770,772],{"className":690,"code":771,"language":692,"meta":693,"style":693},"open \"treehouse:\u002F\u002Fopen?workspace=\u003Cid>&origin=\u003Cweb app>\"\n",[432,773,774],{"__ignoreMap":693},[697,775,776,779],{"class":699,"line":30},[697,777,778],{"class":702},"open",[697,780,781],{"class":702}," \"treehouse:\u002F\u002Fopen?workspace=\u003Cid>&origin=\u003Cweb app>\"\n",[557,783,784],{},"Tell them what to do in the window that opens: sign in if it asks, then confirm where to keep the folder. On a self-hosted server the app first asks whether to trust the server's address.",[557,786,787,788,791,792,794],{},"Check ",[432,789,790],{},"links.json"," every few seconds until the workspace appears, for up to 10 minutes. Its ",[432,793,650],{}," is the folder.",[428,796,797,800],{},[560,798,799],{},"On Linux on arm64 or on Windows",", or on an Apple silicon Mac if the desktop app doesn't suit them, use the CLI:",[678,802,803,870,921,928],{},[557,804,805,806,827,830,831,834,835,837,838,841,842,845,846,849,850,861,837,863,866,867,834],{},"Install it. On macOS or Linux:",[688,807,809],{"className":690,"code":808,"language":692,"meta":693,"style":693},"curl -fsSL https:\u002F\u002Fdl.trytree.house\u002Finstall.sh | sh\n",[432,810,811],{"__ignoreMap":693},[697,812,813,815,817,820,824],{"class":699,"line":30},[697,814,703],{"class":702},[697,816,707],{"class":706},[697,818,819],{"class":706}," https:\u002F\u002Fdl.trytree.house\u002Finstall.sh",[697,821,823],{"class":822},"sDOmQ"," |",[697,825,826],{"class":702}," sh\n",[828,829],"br",{},"On Windows, in PowerShell: ",[432,832,833],{},"irm https:\u002F\u002Fdl.trytree.house\u002Finstall.ps1 | iex",".",[828,836],{},"If ",[432,839,840],{},"treehouse"," isn't found straight afterwards, call it by its full path rather than asking them to open a new terminal: ",[432,843,844],{},"~\u002F.local\u002Fbin\u002Ftreehouse"," on macOS and Linux. On Windows, PowerShell needs the call operator ",[432,847,848],{},"&"," in front of the path:",[688,851,855],{"className":852,"code":853,"language":854,"meta":693,"style":693},"language-powershell shiki shiki-themes everforest-dark","& \"$env:LOCALAPPDATA\\Treehouse\\bin\\treehouse.exe\" login \"$HOME\u002FTreehouse\u002F\u003Cworkspace name>\" --workspace \u003Cid>\n","powershell",[432,856,857],{"__ignoreMap":693},[697,858,859],{"class":699,"line":30},[697,860,853],{},[828,862],{},[432,864,865],{},"TREEHOUSE_BIN_DIR"," is set, the installer used that folder instead: ",[432,868,869],{},"& \"$env:TREEHOUSE_BIN_DIR\\treehouse.exe\" ...",[557,871,872,873,911,913,914,916,917,920],{},"Connect a folder. Quote the path: workspace names often contain spaces and apostrophes.",[688,874,876],{"className":690,"code":875,"language":692,"meta":693,"style":693},"treehouse login \"$HOME\u002FTreehouse\u002F\u003Cworkspace name>\" --workspace \u003Cid>\n",[432,877,878],{"__ignoreMap":693},[697,879,880,882,885,888,892,895,898,901,904,908],{"class":699,"line":30},[697,881,840],{"class":702},[697,883,884],{"class":706}," login",[697,886,887],{"class":702}," \"",[697,889,891],{"class":890},"s9lfW","$HOME",[697,893,894],{"class":702},"\u002FTreehouse\u002F\u003Cworkspace name>\"",[697,896,897],{"class":706}," --workspace",[697,899,900],{"class":822}," \u003C",[697,902,903],{"class":706},"i",[697,905,907],{"class":906},"sY0Nt","d",[697,909,910],{"class":822},">\n",[828,912],{},"Add ",[432,915,542],{}," on a self-hosted server. The command prints an approval link and a code, and opens the browser at ",[560,918,919],{},"Approve this device"," with the workspace already chosen.",[557,922,923,924,927],{},"Give them the link and the code it printed, in case the browser didn't open in front of them. Ask them to check the code matches, then select ",[560,925,926],{},"Connect to"," the workspace.",[557,929,930,931,933],{},"The command waits up to 10 minutes for that, then starts syncing. If your shell would time out sooner, run it in the background and check ",[432,932,654],{}," until the folder shows up.",[428,935,936,939,940,834],{},[560,937,938],{},"On an Intel Mac or on Linux on x64",", there's no ready-made sync app yet: the installer stops with a message saying so. ",[571,941,942],{"href":573},"Connect over MCP instead",[549,944,946],{"id":945},"_4-check-its-syncing","4. Check it's syncing",[428,948,949],{},"Check this before you create anything. A folder that isn't syncing still accepts files, so you could build the whole structure without any of it reaching the web app.",[428,951,952],{},"If the CLI is installed:",[678,954,955,976,1076],{},[557,956,957,958,960,961,964,965,968,969,972,973,975],{},"Run ",[432,959,654],{}," and read its first line before anything else. ",[432,962,963],{},"treehouse is not running (last known state)"," means nothing is syncing, whatever the folder's badge says: the badges below it are only the last state recorded. Run ",[432,966,967],{},"treehouse start",", and ",[432,970,971],{},"treehouse resume \"\u003Cfolder>\""," if the folder is paused, then run ",[432,974,654],{}," again.",[557,977,978,979,982,983],{},"Once the first line says ",[432,980,981],{},"treehouse is running",", act on the folder's badge:",[452,984,985,995],{},[455,986,987],{},[458,988,989,992],{},[461,990,991],{},"Badge",[461,993,994],{},"What it means and what to do",[468,996,997,1007,1017,1027,1039,1050,1063],{},[458,998,999,1004],{},[473,1000,1001],{},[432,1002,1003],{},"✓ synced",[473,1005,1006],{},"It's working.",[458,1008,1009,1014],{},[473,1010,1011],{},[432,1012,1013],{},"● starting",[473,1015,1016],{},"Sync is starting up. Check again in a few seconds.",[458,1018,1019,1024],{},[473,1020,1021],{},[432,1022,1023],{},"⇅ syncing",[473,1025,1026],{},"Files are moving. Check again in a few seconds.",[458,1028,1029,1034],{},[473,1030,1031],{},[432,1032,1033],{},"◐ polling",[473,1035,1036,1037,834],{},"Syncing, but it notices local changes every few seconds rather than instantly. Check again until ",[432,1038,1003],{},[458,1040,1041,1046],{},[473,1042,1043],{},[432,1044,1045],{},"‖ paused",[473,1047,1048],{},[432,1049,971],{},[458,1051,1052,1057],{},[473,1053,1054],{},[432,1055,1056],{},"⚠ sign in",[473,1058,1059,1062],{},[432,1060,1061],{},"treehouse login --force \"\u003Cfolder>\" --workspace \u003Cid>",", and they approve it again",[458,1064,1065,1070],{},[473,1066,1067],{},[432,1068,1069],{},"✗ error",[473,1071,1072,1075],{},[432,1073,1074],{},"treehouse logs"," shows what went wrong.",[557,1077,1078,1079,1081,1082,834],{},"Start building only when the first line says ",[432,1080,981],{}," and the folder shows ",[432,1083,1003],{},[428,1085,1086,1087,1089,1090,1093],{},"Without the CLI, look at the folder's entry in ",[432,1088,790],{},": ",[432,1091,1092],{},"\"paused\": true"," means it's paused. Ask them to check the folder in the Treehouse menu bar icon and resume it, or sign in again, from there.",[428,1095,1096,1097,1100,1101,1103],{},"Then list the folder. A new workspace holds ",[432,1098,1099],{},"README.md"," and ",[432,1102,434],{},". If it's empty, give it a few seconds: the first sync is still running.",[549,1105,1107],{"id":1106},"_5-work-in-the-folder","5. Work in the folder",[428,1109,1110,1111,1114],{},"If your session started somewhere else, work in the folder by its full path. Never read, edit or delete the ",[432,1112,1113],{},".treehouse\u002F"," folder inside it: it holds the sync settings and key.",[428,1116,1117],{},"Your changes reach the web app within a few seconds. You can tell them to open the workspace there and watch it fill up.",[549,1119,1121],{"id":1120},"_6-follow-agentsmd","6. Follow AGENTS.md",[428,1123,1124,1125,1127],{},"Read ",[432,1126,434],{}," at the root of the workspace and follow it. In a new workspace it's a setup guide: you'll interview them about what the workspace is for, propose a folder structure, build it once they agree, and finish by suggesting what to set up next.",[437,1129,942],{"id":1130},"connect-over-mcp-instead",[428,1132,1133],{},"If you can't install anything, or their computer has no ready-made sync app, connect to the workspace over MCP. There's no key involved: the person signs in through their browser.",[678,1135,1136,1142,1148],{},[557,1137,1138,1139,1141],{},"Ask them to add the prompt's MCP server address as a remote MCP server, with no key. In Claude Cowork, Claude Desktop and claude.ai that's a custom connector; in ChatGPT, a connector. ",[571,1140,88],{"href":75}," shows where it goes in each client.",[557,1143,1144,1145,834],{},"When the client connects, it opens their browser. They sign in to Treehouse, name the connection and select ",[560,1146,1147],{},"Allow",[557,1149,1150,1151,1154],{},"Call ",[432,1152,1153],{},"list_workspaces"," and use the workspace id from the prompt in every tool call.",[428,1156,1157,1158,1161,1162,1161,1165,1168],{},"Over MCP you read and write with the Treehouse tools (",[432,1159,1160],{},"list_files",", ",[432,1163,1164],{},"read_file",[432,1166,1167],{},"write_file",") instead of a folder, and steps 2 to 5 don't apply.",[437,1170,1172],{"id":1171},"check-it-worked","Check it worked",[554,1174,1175,1188],{},[557,1176,1177,1178,1180,1181,1183,1184,1100,1186,834],{},"The workspace's entry is in ",[432,1179,790],{}," (or ",[432,1182,654],{},"), and its folder holds ",[432,1185,1099],{},[432,1187,434],{},[557,1189,1190],{},"A file you create in the folder appears in the web app within a few seconds.",[437,1192,320],{"id":1193},"troubleshooting",[549,1195,1197],{"id":1196},"the-desktop-app-link-does-nothing","The desktop app link does nothing",[428,1199,1200,1201,1203],{},"The app isn't installed or hasn't been opened yet. Open ",[432,1202,685],{}," once, then open the link again.",[549,1205,1207],{"id":1206},"the-approval-page-shows-a-different-workspace","The approval page shows a different workspace",[428,1209,1210,1211,1214,1215,1218],{},"The CLI you have may be older than the ",[432,1212,1213],{},"--workspace"," flag. Ask them to choose the workspace named in the prompt, or run ",[432,1216,1217],{},"treehouse update"," first.",[549,1220,1222],{"id":1221},"the-workspace-already-has-folders","The workspace already has folders",[428,1224,1225,1226,1228],{},"Someone has set it up already. ",[432,1227,434],{}," says so too. Don't start again: ask what they want changed.",[1230,1231,1232],"style",{},"html pre.shiki code .sRC7j, html code.shiki .sRC7j{--shiki-default:#A7C080}html pre.shiki code .sySyC, html code.shiki .sySyC{--shiki-default:#DBBC7F}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sDOmQ, html code.shiki .sDOmQ{--shiki-default:#E69875}html pre.shiki code .s9lfW, html code.shiki .s9lfW{--shiki-default:#D699B6}html pre.shiki code .sY0Nt, html code.shiki .sY0Nt{--shiki-default:#D3C6AA}",{"title":693,"searchDepth":11,"depth":49,"links":1234},[1235,1236,1237,1245,1246,1247],{"id":439,"depth":11,"text":440},{"id":446,"depth":11,"text":447},{"id":546,"depth":11,"text":547,"children":1238},[1239,1240,1241,1242,1243,1244],{"id":551,"depth":49,"text":552},{"id":588,"depth":49,"text":589},{"id":658,"depth":49,"text":659},{"id":945,"depth":49,"text":946},{"id":1106,"depth":49,"text":1107},{"id":1120,"depth":49,"text":1121},{"id":1130,"depth":11,"text":942},{"id":1171,"depth":11,"text":1172},{"id":1193,"depth":11,"text":320,"children":1248},[1249,1250,1251],{"id":1196,"depth":49,"text":1197},{"id":1206,"depth":49,"text":1207},{"id":1221,"depth":49,"text":1222},"md",{},true,[99,81,100],{"title":94,"description":97},"docs\u002Fagents\u002Fconnect\u002Fset-up-a-workspace","vHyu3Od4Zz6E9SWyxBhid6i6RsAwjzCpjRXo7ksa-HM",1793370243654]