skills.rest
cbrostrom
cbrostromCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

paseo

Manage Paseo daemon projects, workspaces, agents, schedules, and heartbeats via MCP tools and CLI.

Updated Nov 25, 2024
Search Tags:#cli#agent orchestration#worktree#mcp tools#coding agents#cron scheduling#paseo
One-click install
npx skills add https://github.com/cbrostrom/dotfiles --skill paseo-cbrostrom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: paseo
Source: https://github.com/cbrostrom/dotfiles/tree/main/stow/agents/.agents/skills/paseo
Command: npx skills add https://github.com/cbrostrom/dotfiles --skill paseo-cbrostrom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating coding agents, isolated workspaces, and recurring tasks across a Paseo daemon requires knowing many MCP tools and CLI commands; this Skill provides the operational reference for managing that lifecycle correctly. ## Core Features & Use Cases - Workspace and Project Management: Create, list, rename, and archive projects and workspaces, including worktree isolation modes like branch-off, checkout-branch, and checkout-pr. - Agent Orchestration: Create agents with provider/model settings, send follow-up prompts, use agent profiles, and rely on notifyOnFinish notifications instead of polling. - Schedules and Heartbeats: Start recurring agents on cron cadences or send heartbeat prompts back to the current conversation for reminders and status checks. - Use Case: Delegate a bug fix by creating a worktree workspace with branch-off isolation, launching a Codex agent with fast mode enabled, and getting notified when it finishes. ## Quick Start Ask the agent to create a Paseo worktree workspace for a new branch and launch a coding agent on it with a prompt describing the task.

Frequently Asked Questions about paseo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an isolated workspace in Paseo?▼

Use create_workspace with isolation set to worktree and a mode of branch-off, checkout-branch, or checkout-pr. Branch-off takes branchName and baseBranch, checkout-branch takes an existing branch, and checkout-pr takes a prNumber.

How do I launch a coding agent with Paseo?▼

Call create_agent with a title, a provider such as codex/gpt-5.4 or claude/opus, and an initialPrompt. Optionally pass a workspaceId for isolated delegation and settings like modeId or provider features.

What is the difference between Paseo schedules and heartbeats?▼

Schedules start a fresh agent on a cron cadence and support the full list, update, pause, and resume surface. Heartbeats send a prompt back to your current conversation and can only be created or deleted, not updated.

Should I poll Paseo to check if an agent finished?▼

No. Leave notifyOnFinish enabled on create_agent and background send_agent_prompt calls, and you will be notified when the agent finishes, errors, or needs permission. Polling list_agents is discouraged.

How do I enable Codex fast mode for a Paseo agent?▼

Pass settings with features containing fast_mode set to true on create_agent or update_agent. Confirm the feature exists first by calling inspect_provider for the Codex provider.

Related Skills

Explore More Software Engineering Skills→
getpaseogetpaseo
15.7k

paseo-plugin

Build, install, and manage trusted local Paseo plugins with React Native surfaces and RPC handlers.

Official
Advanced
attrigoattrigo

asapp-close-task

Squash-merge a completed task branch into local main with verification.

Community
Advanced
getpaseogetpaseo
15.7k

paseo-help

Diagnose Paseo setup, connectivity, provider, and update issues using current documentation.

Official
Intermediate
compozycompozy
182

agh-worktree-isolation

Isolate AGH_HOME, daemon ports, and tmux sockets for concurrent agent worktrees.

Official
Intermediate