CLI を使う場面
CLI エージェントはターミナルから Btelo Coding を実行します。以下の場合に適しています：
- Linux を使用している — Linux にはデスクトップアプリがありません。
- デスクトップ環境のないヘッドレスサーバーや VPS で実行している。
- エージェントの起動をスクリプト化または自動化したい。
Mac と Windows では、デスクトップアプリ がエージェントを実行する推奨方法です — ワンダウンロード、ガイド付きセットアップ、ターミナル不要。これらのプラットフォームで CLI を使うのは、ターミナルワークフローを特に望む場合に限ります。
インストール
Linux / macOS：
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows（PowerShell）：
irm https://coding.btelo.com/install.ps1 | iex
エージェントの起動
vibe-remote
TUI が表示されます。c を押してコネクタ名とパスワードを設定します。エージェントは自動的にクラウドリレーに接続し、Dashboard にペアリング QR コードを表示します。iOS アプリ からスキャンして接続してください。
TUI ショートカット（Dashboard タブ）：
| キー | 操作 |
|---|---|
| c | Config — コネクタ名とパスワードを設定 |
| w | リレーサーバーを切り替え |
| d | 接続されたデバイスを管理 |
| r | QR コードを更新 |
| h | QR コードの表示 / 非表示 |
| m | QR ロールの切り替え（Admin / Member） |
| y | QR リンクをクリップボードにコピー |
| t | Desktop ヘルプ |
| i | Install QR（App Store リンク） |
| u | アップデート後に再起動 |
| s | サーバー停止 |
| q | TUI 終了 |
| 1/2/3 | タブ切り替え（Dashboard / Logs / Install） |
Logs タブ： g で先頭へ移動、G で末尾へ移動、x でログをクリア。
Devices モーダル： k で選択したデバイスをキック、r でリストを更新。
Headless モード
Windows ではインタラクティブ TUI が利用できず、ヘッドレスサーバーでも不要です。代わりに TUI なしで起動します：
vibe-remote --headless --connector myconnector --password mypassword
アップデート
vibe-remote update
アップデートのダウンロード後、TUI で u を押すと、接続を切断せずに新しいバージョンで再起動できます。
CLI リファレンス
vibe-remote Start TUI (default)
vibe-remote --headless Start without TUI
vibe-remote client Connect to a remote agent (reverse mode)
vibe-remote relay Run as relay server
vibe-remote delete-connector Delete the saved connector
vibe-remote update Update to latest version
vibe-remote version Show version
vibe-remote help Show help