paseo
Installation
SKILL.md
Paseo is a daemon that supervises AI coding agents on your machine. Control it through tools or a CLI.
Worktrees
create_worktree — same target union as create_agent.workspace.source.worktree.target:
- From a PR:
{ target: { kind: "checkout-pr", githubPrNumber: 503 } }. - Branch off a base:
{ target: { kind: "branch-off", worktreeSlug: "foo", branchName: "fix/foo", baseBranch: "main" } }. - Checkout an existing branch:
{ target: { kind: "checkout-branch", branch: "feat/bar" } }.
Returns { branchName, worktreePath, workspaceId }. Pass cwd to target a specific repo.
In branch-off, worktreeSlug controls the worktree path slug and branchName controls the git branch. If branchName is omitted, Paseo defaults it from worktreeSlug. The returned branchName is authoritative; checkout and PR flows may return a branch name that differs from any requested slug.
list_worktrees — current repo (or pass cwd).
archive_worktree — { worktreePath } or { worktreeSlug }. Removes worktree and branch.