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.