# Paseo > Referencia de Paseo para gestionar proyectos, workspaces, scripts de workspace, agentes, schedules y heartbeats. Paseo es un daemon remoto que administra agentes de código y terminales, controlable por MCP o por CLI. Fuente: https://skillsagentes.com/skills/getpaseo/paseo/paseo Markdown: https://skillsagentes.com/skills/getpaseo/paseo/paseo.md Repositorio: https://github.com/getpaseo/paseo Autor: getpaseo Licencia: NOASSERTION Actualizado: hace 2 meses Coste de contexto: 26 tok instalada, 2k tok al activarse, 2k tok con todos los archivos del bundle Bundle: 1 archivo, 8 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add getpaseo/paseo --skill paseo --agent claude-code # Cursor npx -y skills add getpaseo/paseo --skill paseo --agent cursor # Codex npx -y skills add getpaseo/paseo --skill paseo --agent codex # Gemini CLI npx -y skills add getpaseo/paseo --skill paseo --agent gemini # Windsurf npx -y skills add getpaseo/paseo --skill paseo --agent windsurf # Cline npx -y skills add getpaseo/paseo --skill paseo --agent cline ``` ## Qué hace - Da la referencia para controlar Paseo, un daemon remoto que gestiona agentes de código y terminales, por herramientas MCP o por CLI. - Gestiona el registro de proyectos del daemon: `paseo project create/ls/rename/delete`, que archiva los workspaces activos sin borrar el directorio. - Crea y administra workspaces con aislamiento `local` o `worktree` (branch-off, checkout-branch, checkout-pr) y sus scripts supervisados de `paseo.json`. - Lanza agentes con `create_agent` (provider tipo `claude/opus` o `codex/gpt-5.4`, prompt inicial y perfiles), les manda follow-ups y los archiva. - Programa trabajo recurrente: `create_schedule` arranca agentes nuevos en cron y `create_heartbeat` te devuelve un prompt a esta conversación. ## Cuándo usarla - Gestionar proyectos, workspaces, scripts de workspace, agentes, schedules o heartbeats de Paseo. - Delegar trabajo a subagentes en workspaces aislados y esperar su notificación de fin. - Montar tareas recurrentes con agentes frescos o recordatorios que vuelven al chat. ## Cuándo no - Dudas de producto, configuración, logs, versiones o troubleshooting: usa la skill paseo-help. ## Qué la activa - "Crea un workspace en worktree sobre la rama fix-x y lanza un agente de Codex ahí" - "Lista los agentes activos de este proyecto" - "Programa un agente cada 15 minutos que vigile el build de main" - "Manda un follow-up al agente que está revisando el PR 42" - "Archiva el workspace cuando termine" ## Antes de instalar - Necesita un daemon de Paseo en marcha, accesible por sus herramientas MCP o por la CLI `paseo` (local, o remoto con `--host` / `PASEO_HOST`). ## Archivos - SKILL.md — 8 KB ## SKILL.md Reproducido tal cual desde getpaseo/paseo bajo NOASSERTION. Esta sección es el documento original y está en inglés. Paseo is a remote daemon that manages coding agents, terminals. Control it through MCP tools or the CLI. ## Connected hosts Call `list_hosts` to discover the calling daemon (`self`) and its registered destinations (`hosts`). Use a destination's `serverId` for tool calls; labels are display names. `create_workspace`, `list_workspaces`, `create_agent`, `send_agent_prompt`, `get_agent_status`, `get_agent_activity`, and `list_agents` accept `serverId`. Omit it for the calling daemon. Other MCP tools operate on the calling daemon. Keep an agent's `{ serverId, agentId }` together. For example, call `send_agent_prompt` with: ```json { "serverId": "srv_build", "agentId": "agent_123", "prompt": "Continue", "notifyOnFinish": true } ``` Remote paths and workspace IDs belong to the destination. Remote `list_agents` has no caller-directory default; pass `cwd` to filter it. Manage registrations through the CLI; use the returned `registrationId` for updates and removal: ```bash paseo --host localhost:6768 host add localhost:6779 --label build paseo --host localhost:6768 host ls --json ``` ## Projects Manage the daemon's project registry through the CLI: ```bash paseo project create [path] paseo project ls paseo project rename paseo project rename --reset paseo project delete ``` For a local daemon, `project create` defaults to the current directory and resolves relative paths on the CLI machine. With `--host` or `PASEO_HOST`, 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 **`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` for a change request. Use `path` for a local directory or source checkout and `projectId` for the owning project; when no path is supplied, a worktree may resolve its source from `projectId`. `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. **`list_workspaces`** — list active workspaces, excluding background workspaces unless `includeBackground: true`. **`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. **`rename_workspace`** — `{ workspaceId, name }`. Rename workspace. ## 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 terminal and returns the stopped status metadata. The matching CLI surface accepts either an explicit workspace ID or resolves the current directory: ```bash paseo script ls [--cwd | --workspace ] paseo script start [--cwd | --workspace ] paseo script stop [--cwd | --workspace ] ``` ## Agents **`create_agent`** — required: `title`, `provider` (`claude/opus`, `codex/gpt-5.4`, …), `initialPrompt`. Optional: `workspaceId`, `notifyOnFinish`, `settings`, `labels`. Returns `{ agentId, workspaceId, … }`. Initial runtime settings live under `settings`: `modeId`, `thinkingOptionId`, and provider-specific `features`. Agent profiles are the preferred source for these values. For Codex fast mode, pass `settings: { features: { "fast_mode": true } }` when creating the agent. Agent-scoped creation always creates your subagent. On your own host, omit `workspaceId` to use your current workspace. On another host, first list or create a workspace with that `serverId`, then pass its `workspaceId` and the same `serverId` to `create_agent`. Placement never changes parentage. Detach is an explicit user action in the subagents track, not an agent tool. A cross-workspace child remains your subagent even though it also appears as a normal tab in its workspace. Agent-scoped `create_agent` defaults `notifyOnFinish` to true. Set it to `false` when you want explicit reporting or no completion callback. **`send_agent_prompt`** — `{ agentId, prompt, activeTurnBehavior? }`. Use for follow-ups to an existing agent. Agent-scoped calls default to `steer`; top-level calls default to `interrupt`. Set `activeTurnBehavior` to `steer` or `interrupt` to override the default. Steering falls back to interruption when unavailable. CLI agent sends use the same defaults and accept `--behavior steer|interrupt`. Agent-scoped calls return a queued receipt immediately; messages to each recipient deliver after two quiet seconds. Top-level calls return after dispatch acknowledgement. Agent-scoped calls default `notifyOnFinish` to true; top-level calls have no parent callback. **`update_agent`** — `{ agentId, name?, labels?, settings? }`. Use `settings` for runtime changes on an existing agent: `modeId`, `model`, `thinkingOptionId`, and provider-specific `features`. For Codex fast mode, pass `settings: { features: { "fast_mode": true } }`. **`list_agents`** — filter by `cwd`, `statuses`, `sinceHours`, `includeArchived`; set `includeBackground: true` to include agents in background workspaces. **`archive_agent`** — `{ agentId }`. Interrupts if running, removes from active list. ## Agent profiles and provider discovery **`list_profiles`** — named launch bundles configured by the human. Before choosing how to launch a delegated agent, call this tool and read every profile's `notes`. Pick a named profile the user requested, or the profile whose notes best match the work. There is no `profile` parameter on `create_agent`. Materialize the selected profile into the call: - combine `provider` and `model` as the `provider/model` value for `create_agent.provider` - copy `modeId` to `settings.modeId` - copy `thinkingOptionId` to `settings.thinkingOptionId` - copy `featureValues` to `settings.features` Omit absent values. Do not remember a selected profile or infer drift later; a profile is only launch configuration. If no profile fits, or no profiles are configured, use the provider discovery tools below rather than guessing. Tell the user when you fall back because no configured profile fits. **`list_providers`** — compact provider availability and modes. **`list_models`** — full model list for one provider. Use only when you need model IDs or thinking options; the list can be large. **`inspect_provider`** — compact provider capability and feature inspection. Required: `provider`; pass `cwd` when you are not in an agent-scoped session. Optional: `settings` with draft `model`, `modeId`, `thinkingOptionId`, and `features`. Only set feature IDs returned by `inspect_provider`. For Codex fast mode, look for `fast_mode` and pass `settings: { features: { "fast_mode": true } }` to `create_agent` or `update_agent`. ## Schedules and heartbeats **`create_schedule`** — starts a new agent on a cron cadence. Required: `prompt`, `cron`, `provider`. Optional: `timezone`, `name`, `cwd`, `maxRuns`, `expiresIn`. Use when the recurring work should live in fresh agents. **`create_heartbeat`** — sends you a prompt on a cron cadence. Required: `prompt`, `cron`. Optional: `timezone`, `name`, `maxRuns`, `expiresIn`. Use for reminders, PR/build babysitting, and status checks that should return to this conversation. **`delete_heartbeat`** stops it. MCP intentionally exposes no heartbeat update tool; delete and recreate when its task or cadence changes. Schedules have the full list/inspect/update/pause/resume/run-once/log/delete surface. Heartbeats deliberately do not. ## Waiting When you create or prompt a subagent, `notifyOnFinish` defaults to `true` and reports completion, errors, or permission requests, including across hosts. Finish your turn and wait for that notification instead of polling. If you want an explicit reply with `send_agent_prompt`, have the sender check `list_hosts` for the recipient’s server before setting `notifyOnFinish: false`. ## CLI semantics The CLI and tools use the same ownership semantics even where their syntax differs: ```bash paseo workspace create --isolation worktree --mode branch-off --new-branch fix-x --base origin/main paseo workspace create --isolation worktree --mode checkout-branch --branch existing-work paseo workspace create --isolation worktree --mode checkout-pr --pr-number 42 paseo run --provider codex/gpt-5.4 --mode full-access --workspace "" paseo run --provider codex/gpt-5.4 --mode full-access --new-workspace worktree --worktree-mode branch-off --new-branch fix-x --base origin/main "" paseo send "" paseo ls paseo schedule create --cron "*/15 * * * *" "ping main build" paseo heartbeat create --cron "*/15 * * * *" "check the build" ``` Discover with `paseo --help` and `paseo --help`. For product questions, setup, logs, version problems, or troubleshooting, use the **paseo-help** skill. ## Dónde encaja - Categoría: [Automatización](https://skillsagentes.com/categorias/automatizacion.md) — Flujos de varios pasos que se ejecutan sin supervisión. - Creador: [getpaseo](https://skillsagentes.com/creators/getpaseo.md) — 8 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Paseo Plugin](https://skillsagentes.com/skills/getpaseo/paseo/paseo-plugin.md): Construye y gestiona plugins locales de confianza para Paseo: crear, editar, instalar, recargar, activar, desactivar, quitar o depurar un plugin, añadir superficies nativas o de barra lateral, o añadir RPC y attachments del composer. - [Paseo Handoff](https://skillsagentes.com/skills/getpaseo/paseo/paseo-handoff.md): Transfiere la tarea actual a otro agente con todo el contexto: decisiones, intentos fallidos y restricciones en un briefing autocontenido. Se activa con "handoff", "hand off" o "hand this to". - [Paseo Committee](https://skillsagentes.com/skills/getpaseo/paseo/paseo-committee.md): Forma un comité de dos agentes de alto razonamiento que dan un paso atrás, hacen análisis de causa raíz y producen un plan. Úsala cuando estés atascado, en bucle, con visión de túnel o ante un problema de planificación difícil. - [Release Beta](https://skillsagentes.com/skills/getpaseo/paseo/release-beta.md): Corta una release beta de Paseo. Se activa con "release beta", "cut a beta", "ship a beta", "beta release" o "/release-beta", y sigue el Beta flow y su checklist en `docs/release.md`. - [Paseo Advisor](https://skillsagentes.com/skills/getpaseo/paseo/paseo-advisor.md): Levanta un único agente como asesor para una segunda opinión sobre la tarea actual. Se activa con "advisor", "segunda opinión" o "qué piensa X", cuando quieres una mirada externa sin delegar el trabajo en sí. ## Skills relacionadas - [Paseo Advisor](https://skillsagentes.com/skills/getpaseo/paseo/paseo-advisor.md): Levanta un único agente como asesor para una segunda opinión sobre la tarea actual. Se activa con "advisor", "segunda opinión" o "qué piensa X", cuando quieres una mirada externa sin delegar el trabajo en sí. - [Paseo Committee](https://skillsagentes.com/skills/getpaseo/paseo/paseo-committee.md): Forma un comité de dos agentes de alto razonamiento que dan un paso atrás, hacen análisis de causa raíz y producen un plan. Úsala cuando estés atascado, en bucle, con visión de túnel o ante un problema de planificación difícil. - [Paseo Handoff](https://skillsagentes.com/skills/getpaseo/paseo/paseo-handoff.md): Transfiere la tarea actual a otro agente con todo el contexto: decisiones, intentos fallidos y restricciones en un briefing autocontenido. Se activa con "handoff", "hand off" o "hand this to". - [Paseo Help](https://skillsagentes.com/skills/getpaseo/paseo/paseo-help.md): Responde dudas sobre el producto y la app de Paseo: setup, configuración, conectividad, providers, workspaces, actualizaciones, logs y troubleshooting. Para operar agentes y workspaces por MCP o CLI, usa la skill paseo. - [Paseo Plugin](https://skillsagentes.com/skills/getpaseo/paseo/paseo-plugin.md): Construye y gestiona plugins locales de confianza para Paseo: crear, editar, instalar, recargar, activar, desactivar, quitar o depurar un plugin, añadir superficies nativas o de barra lateral, o añadir RPC y attachments del composer. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)