Agent skill · software engineering · getpaseo
paseo
Paseo reference for managing projects, workspaces, workspace scripts, agents, schedules, and heartbeats.
Why this skill is useful
Adds executable CLI commands for managing AI agents and workspaces, which are not commonly found in public documentation.
What it needs
Requires paseo installed locally. About 5k tokens when loaded. Last updated 2026-08-07. 12,523 stars on the source repository.
What this skill does
Paseo is a remote daemon that manages coding agents, terminals. Control it through MCP tools or the CLI. Projects Manage the daemon's project registry through the CLI: For a local daemon, project create defaults to the current directory and resolves relative paths on the CLI machine. With --host or PASEOHOST, always provide a path; the target daemon interprets it on its own machine. Deleting a project archives its active workspaces and removes the project from Paseo without deleting the project directory. Workspaces createworkspace — 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. background: true hides a workspace from default lists and the sidebar while its contents remain durable and accessible; omit background to inherit your current workspace’s value (false without a caller), and override it only when the user explicitly asks. Choose baseBranch explicitly: origin/main selects the remote-tracking branch; refs/heads/main selects local main. Bare main prefers local main when it exists, otherwise origin/main. Paseo retains the resolved ref for workspace comparisons, even after rebasing the branch or changing its PR target. listworkspaces — list active workspaces, excluding background workspaces unless includeBackground: true. archiveworkspace — { 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. renameworkspace — { workspaceId, name }. Rename workspace. Workspace scripts Configured paseo.json scripts use the same supervised lifecycle from tools and the CLI. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills getpaseo/paseo--9a8061