← ClaudeAtlas

paseolisted

Paseo reference for managing agents and worktrees. Load whenever you need to create agents, send them prompts, or manage worktrees.
getpaseo/paseo · ★ 8,039 · AI & Automation · score 82
Install: claude install-skill getpaseo/paseo
Paseo is a daemon that supervises AI coding agents on your machine. Control it through tools or a CLI. ## Worktrees **`create_worktree`** — three modes: - From a PR: `{ githubPrNumber: 503 }`. - Branch off a base: `{ action: "branch-off", branchName: "fix/foo", baseBranch: "main" }`. - Checkout an existing ref: `{ action: "checkout", refName: "feat/bar" }`. Returns `{ branchName, worktreePath }`. Pass `cwd` to target a specific repo. **`list_worktrees`** — current repo (or pass `cwd`). **`archive_worktree`** — `{ worktreePath }` or `{ worktreeSlug }`. Removes worktree and branch. ## Agents **`create_agent`** — required: `title`, `provider` (`claude/opus`, `codex/gpt-5.4`, …), `initialPrompt`. Common: `cwd` (often a `worktreePath`), `notifyOnFinish`, `settings`, `detached`. Returns `{ agentId, … }`. Initial runtime settings live under `settings`: `modeId`, `thinkingOptionId`, and provider-specific `features`. For Codex fast mode, pass `settings: { features: { "fast_mode": true } }` when creating the agent. Compose: call `create_worktree` first, then `create_agent` with `cwd` set to the returned `worktreePath`. ### Agent relationships Agents you create default to **your subagents**: omit `detached` or pass `detached: false`. Use this for advisors, committee members, planners, implementers, auditors, loop workers, and any agent whose lifetime belongs to your task. Subagents appear under you and are archived with you. Pass `detached: true` only when the agent you crea