paseo-help

Diagnose Paseo daemon, provider, and connectivity issues using current documentation.

Updated Nov 25, 2024
One-click install
npx skills add https://github.com/cbrostrom/dotfiles --skill paseo-help-cbrostrom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: paseo-help
Source: https://github.com/cbrostrom/dotfiles/tree/main/stow/agents/.agents/skills/paseo-help
Command: npx skills add https://github.com/cbrostrom/dotfiles --skill paseo-help-cbrostrom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Users running Paseo often struggle to answer setup, configuration, and troubleshooting questions because the daemon topology (desktop-managed, standalone, or Docker) changes where logs, providers, and config actually live. This Skill answers Paseo product questions directly while grounding every answer in the current public documentation. ## Core Features & Use Cases - Documentation-grounded answers: Fetches the paseo.sh llms.txt index and the relevant Markdown docs page before answering, then links the source. - Topology-aware diagnosis: Identifies whether the daemon is desktop-managed, standalone, or Docker-based, and how the client connects (local, relay, LAN/VPN/Tailscale) before suggesting fixes. - Read-only diagnostics: Uses commands like paseo daemon status --json and paseo provider diagnostic <provider> --json plus known log and config paths to gather evidence without restarting or modifying anything. - Use Case: A user reports their agent provider shows "command not found" in Paseo Desktop connected to a remote server. The Skill identifies the remote daemon as the affected host, runs the provider diagnostic against it, compares the daemon PATH with a fresh login shell, and links the troubleshooting doc. ## Quick Start Ask the paseo-help skill why your Paseo provider is not detected on your remote daemon and have it walk you through the diagnosis.

Frequently Asked Questions about paseo-help

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

FAQPage Schema
How do I troubleshoot Paseo daemon connection problems?▼

First establish the topology: identify whether the daemon is desktop-managed, standalone, or Docker-based, and how the client reaches it (local, relay, or LAN/VPN/Tailscale). Then run paseo daemon status --json on the daemon machine and compare app and daemon versions in Settings → About.

Why does Paseo show command not found for my provider?▼

Run paseo provider diagnostic <provider> against the affected host, or open Settings → your host → Providers → provider → Diagnostic. Compare the resolved binary and daemon PATH with a brand-new login shell, since shell aliases and functions are not executable paths.

Where are Paseo daemon logs and config files located?▼

By default the daemon config is ~/.paseo/config.json and the log is ~/.paseo/daemon.log, with agent state under ~/.paseo/agents/. Substitute the status-reported PASEO_HOME; in the official Docker image the default is /home/paseo/.paseo.

Does Paseo Desktop require a separate daemon installation?▼

No. Paseo Desktop bundles, starts, and updates a daemon on that computer, so no separate install is required. However, Desktop can also connect to other remote standalone or Docker daemons at the same time, so always confirm which host you are diagnosing.

What should I check before restarting or reconfiguring a Paseo daemon?▼

Compare the daemon version with the client app version and update both through the correct topology-specific path, since version skew causes many apparent bugs. Do not restart the daemon, edit config, or expose a network listener without explicit permission, as a restart can interrupt the running agent.