paseo

Paseo is a daemon that supervises AI coding agents on your machine. Control it through tools or a CLI. ## Workspaces **`create_workspace`** — create a workspace independently of any agent. Required: `isolation` (`local` or `worktree`). Worktree isolation supports `mode: "branch-off" | "checkout-branch" | "checkout-pr"`: use `branchName`/`baseBranch` for a new branch, `branch` for an existing branch, or `prNumber` plus optional `forge`/`projectPath` for a change request. `worktreeSlug` controls the managed path. Returns the workspace descriptor centered on `workspaceId`. **`list_workspaces`** — list active workspaces. **`archive_workspace`** — `{ workspaceId }`. Archives the workspace, its agents, and its terminals. Local directories remain; Paseo removes an owned worktree only after its final active workspace reference is archived. Worktree creation and reference accounting are implementation details of `isolation: "worktree"`. ## Workspace scripts Configured `paseo.json` scripts use the same supervised lifecycle from tools and the CLI. **`list_workspace_scripts`** — `{ workspaceId }`. Lists configured scripts with lifecycle, service port, proxy URLs, health, exit code, and terminal ID. **`start_workspace_script`** — `{ workspaceId, scriptName }`. Starts one configured script through Paseo's managed workspace-script launcher and returns its status metadata. **`stop_workspace_script`** — `{ workspaceId, scriptName }`. Stops a running script through its supervised ter...