エージェントが接続できない
- インターネット接続を確認
- リレーに到達可能であることを確認：
curl https://coding.btelo.com/ping - ファイアウォールがアウトバウンドの WebSocket 接続（ポート 443）をブロックしていないか確認
iOS アプリがエージェントを見つけられない
- エージェントが実行中であることを確認 — デスクトップアプリ が起動しているか、CLI エージェント が Cloud: running と表示されているか確認します。
- QR コード / 接続リンクが期限切れの可能性があります — 更新してから再スキャンしてください（デスクトップアプリの Connect パネルを再度開くか、CLI TUI で r を押す）。
- コネクタを再設定した場合は、新しい QR コードをスキャンして再ペアリングしてください。
AI プロバイダーが見つからない
エージェントマシンに少なくとも 1 つのプロバイダーをインストールします：
npm install -g @anthropic-ai/claude-code
CLI が PATH にあることを確認 — claude --version を実行して確認してください。デスクトップアプリでは Settings → Setup guide → Recheck を使用してプロバイダーを再検出できます。または、自分の DeepSeek / MiniMax キーで組み込みの Btelo Agent を使用することもできます。
ポートの競合
エージェントはデフォルトでポート 24385 を使用します。使用中の場合、自動的にランダムポートを選択します。CLI エージェントのカスタムポートを設定するには：
PORT=8080 vibe-remote
最新バージョンへの強制アップデート
デスクトップアプリ： Settings → Check for updates を開き、Restart & update を実行します。それでも更新できない場合は、ダウンロードページ から最新ビルドをダウンロードして既存アプリに上書きインストールしてください。
CLI エージェント： 古いバージョンのまま、または自動更新が適用されない場合は、インストールコマンドを再実行して最新バージョンを取得してください：
Linux / macOS
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows（PowerShell）
irm https://coding.btelo.com/install.ps1 | iex
完了後、エージェントを再起動して新しいバイナリを読み込んでください。
ログ
デスクトップアプリのログはアプリウィンドウから確認できます。CLI エージェントのログは TUI ビューポートに表示されます（headless モードでは stdout に出力されます）。ログファイルは ~/.vibe-remote/logs/ に保存されます。
ヘルプを得る
github.com/btelolabs/btelo-coding-release/issues で issue を報告してください。