paseo-help

Paseo のヘルプ

Paseo 自体の理解、設定、トラブルシューティングをサポートします。質問に直接回答し、現在の公開ドキュメントで内容を確認して、関連するドキュメントへのリンクを含めてください。サポートの代わりに、ユーザーにドキュメントを読むよう促してはいけません。

ユーザーの質問： $ARGUMENTS

現行ドキュメントを使用する

まず https://paseo.sh/llms.txt を取得してください。これは Paseo のドキュメントの現行インデックスで、各ページの説明と Markdown の URL が記載されています。

このインデックスを使って、ユーザーの質問に該当するページを選び、回答する前にリンク先の .md ページを取得してください。トラブルシューティングの場合は、よくある問題から始め、問題がより具体的なページに該当する場合は、そのリンク先も確認してください。

記憶よりも公開中のドキュメントを優先してください。まずユーザーに直接回答し、根拠となる関連 .md ページへのリンクを記載してください。

まずトポロジーを確認する

バージョン、パス、プロバイダー、ログ、アップデート、接続について診断する前に、対象のデーモンを特定してください。クライアントからデーモンを推測してはいけません。Paseo Desktop は、同梱されたローカルデーモンを管理しながら、他のリモートデーモンにも同時に接続できます。

次の 2 点を確認してください。

1. デーモンの実行場所と実行方法
   • デスクトップ管理： Paseo Desktop は、そのコンピューター上にデーモンを同梱し、起動およびアップデートします。別途デーモンをインストールする必要はありません。
   • スタンドアロン： デーモンは別途インストールされており、通常は npm CLI を通じてインストールされ、デスクトップアプリとは独立して実行されます。
   • Docker： デーモン、そのホーム、プロバイダー CLI、認証情報、コードのマウント先は、コンテナーランタイム内にあります。
2. 影響を受けているクライアントからの接続方法
   • 同一マシン上のローカル接続
   • リレー接続
   • LAN、VPN、Tailscale を介した直接接続
   • デーモンが提供する Web UI

Settings → About を使って、アプリのバージョンと接続先ホストごとのバージョンを比較してください。影響を受けているホストについては、Settings → your host → Overview → Full status を開いてください。デーモンを実行しているマシンで paseo daemon status --json を実行すると、サーバー ID、ホスト名、バージョン、ホーム、リッスンアドレス、プロセス所有者、ログパス、デーモンがデスクトップ管理かどうかなどの情報を確認できます。

ユーザーがどのホストを表示しているか、また、そのデーモンをどのマシンまたはコンテナーで実行しているかを記録してください。paseo daemon status は、その CLI のローカルな PASEO_HOME にあるデーモンの情報を示します。アプリで表示中のリモートホストの情報とは限りません。

以降の確認は、クライアントデバイスではなくデーモンの実行環境に対して行ってください。

• プロバイダーのバイナリ、認証情報、PATH、ワークスペース、設定、デーモンのログは、デーモンを実行しているマシン、またはそのコンテナー内にあります。
• アプリのバージョンとアプリのログは、クライアントデバイスにあります。
• デスクトップ管理のデーモンは、Desktop アプリのライフサイクルとアップデート手順に従います。
• スタンドアロンのデーモンは、独自の CLI/npm のライフサイクルに従い、異なる PASEO_HOME またはリッスンアドレスを使用する場合があります。
• Docker のデーモンは、コンテナーパス、ボリューム、ユーザー権限、イメージのバージョン、コンテナーのライフサイクルコマンドを使用します。

状態を変更する前に診断する

影響を受けているホストを特定したら、そのデーモンのバージョンとクライアントアプリのバージョンを比較します。トポロジーに応じた正しい更新手順で、両方を更新するようユーザーに案内します。古いバージョンやアプリとデーモンのバージョン不一致は、見かけ上の不具合の原因となることが多く、修正も頻繁にリリースされています。最新の手順については、Updates ページとインストール方法に応じたドキュメントを参照してください。

関連する最小限の読み取り専用チェックを実行します。

paseo --version
paseo daemon status --json
paseo provider diagnostic <provider> --json

以降のチェックには、ステータスに表示されたホームディレクトリ、リッスンアドレス、ログパスを使用します。http://127.0.0.1:6767/api/health を確認するか、~/.paseo/daemon.log を読むのは、それらの値が対象のデーモンと一致する場合に限ります。ユーザーの明示的な許可なく、デーモンを再起動したり、設定を編集したり、ソフトウェアを更新したり、ネットワークリスナーを公開したりしないでください。デーモンを再起動すると、診断中のエージェントが中断される可能性があります。

プロバイダーが見つからない場合や command not found が表示される場合は、対象のホストで paseo provider diagnostic <provider> を実行するか、Settings → your host → Providers → provider → Diagnostic を開きます。解決されたバイナリ、デーモンの PATH、プロバイダーのバージョンを、新しいログインシェルのものと比較します。シェルのエイリアスや関数は実行可能ファイルのパスではありません。

ログとローカルファイル

デーモンまたはデスクトップアプリが実際に動作しているマシンで、以下のデフォルト値を使用します。リモートデーモンのファイルをクライアントデバイス上で探さないでください。

• デーモン設定：~/.paseo/config.json
• デーモンログ：~/.paseo/daemon.log
• エージェントの状態ディレクトリ：~/.paseo/agents/
• デフォルトの管理対象ワークツリーのルート：~/.paseo/worktrees/
• macOS デスクトップログ：~/Library/Logs/Paseo/main.log
• Linux デスクトップログ：~/.config/Paseo/logs/main.log
• Windows デスクトップログ：%APPDATA%\Paseo\logs\main.log

~/.paseo は、ステータスに表示された PASEO_HOME に置き換えます。公式 Docker イメージでは、デフォルトは /home/paseo/.paseo です。ホスト上のパスはボリュームのマウント方法によって異なり、コンテナの標準出力は Docker から確認できます。デスクトップアプリのログにはデスクトッププロセスの情報が、デーモンログには選択したデーモンの情報が記録されます。必要な最小範囲のログを読み、共有する前に認証情報、ペアリングの招待情報、トークン、パスワード、ユーザーコードを伏せてください。

Paseo Desktop がインストールされたコンピューターで同梱デーモンを診断する際、paseo が PATH にない場合は、同梱 CLI の場所は次のとおりです。

• macOS：/Applications/Paseo.app/Contents/Resources/bin/paseo
• Linux：<install-dir>/resources/bin/paseo
• Windows：C:\Program Files\Paseo\resources\bin\paseo.cmd

PATH の修正またはシンボリックリンクの作成を提案します。シェル設定を黙って変更しないでください。

根拠を添えてエスカレーションする

最新のドキュメントと診断で問題が解決しない場合は、アプリとデーモンのバージョン、OS、インストール方法、接続方法、正確なエラー、最小限の再現手順、機密情報を伏せた短いログ抜粋を収集します。

• バグ：GitHub Issues
• 質問や簡単なサポート：Paseo Discord
• 製品のワークフローに関する議論：GitHub Discussions または Discord の #product