jb/paseo
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add workspaces page explaining project/workspace/session model

Browse Source 
Adds a new conceptual Workspaces doc that explains how Paseo organizes work around projects, workspaces, and sessions. Reframed the existing Git worktrees page as the technical deep-dive it always was. Updated glossary with agent session and tab terminology. Reordered docs nav so workspaces and worktrees come before providers.
This commit is contained in:
Mohamed Boudra
2026-06-10 15:50:19 +07:00
parent 7be9cc0d0b
commit 8e6455f1d6
16 changed files with 72 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
public-docs/worktrees.md
+6 -2
View File
@@ -2,12 +2,16 @@
title: Git worktrees
description: Run agents in isolated git worktrees with setup hooks, scripts, and long-running services.
nav: Git worktrees
order: 7
order: 4
---
# Git worktrees
Each agent runs in its own git worktree, a separate directory on a separate branch, so parallel agents never step on each other. You configure setup, scripts, and long-running services through a `paseo.json` file at your repo root.
Git worktrees are one kind of workspace.
A [workspace](/docs/workspaces) is the place where a task happens. When that workspace is backed by a git worktree, Paseo creates a separate directory on a separate branch so parallel agents never step on each other.
This page covers the git-specific details: where worktrees live, how branches are chosen, and how to configure setup hooks, scripts, terminals, and long-running services through `paseo.json`.
## Layout and workflow