Wann du den CLI verwendest
Der CLI-Agent führt Btelo Coding vom Terminal aus. Er ist die richtige Wahl, wenn:
- Du Linux verwendest — es gibt keine Desktop-App für Linux.
- Du auf einem headless Server oder VPS ohne Desktop-Umgebung arbeitest.
- Du den Start des Agenten automatisieren oder skripten möchtest.
Auf Mac und Windows ist die Desktop-App der empfohlene Weg, den Agenten auszuführen — ein Download, eine geführte Einrichtung und kein Terminal. Greife dort nur auf den CLI zurück, wenn du ausdrücklich einen Terminal-Workflow bevorzugst.
Installation
Linux / macOS:
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows (PowerShell):
irm https://coding.btelo.com/install.ps1 | iex
Agenten starten
vibe-remote
Das TUI erscheint. Drücke c, um deinen Connector-Namen und dein Passwort festzulegen. Der Agent verbindet sich automatisch mit dem Cloud-Relay und zeigt einen Kopplungs-QR-Code im Dashboard an. Scanne ihn aus der iOS-App, um dich zu verbinden.
TUI-Tastenkürzel (Dashboard-Tab):
| Taste | Aktion |
|---|---|
| c | Konfiguration — Connector-Name und Passwort festlegen |
| w | Relay-Server wechseln |
| d | Verbundene Geräte verwalten |
| r | QR-Code aktualisieren |
| h | QR-Code ein-/ausblenden |
| m | QR-Rolle umschalten (Admin / Mitglied) |
| y | QR-Link in Zwischenablage kopieren |
| t | Desktop-Hilfe |
| i | Installations-QR (App-Store-Link) |
| u | Nach Update neu starten |
| s | Server stoppen |
| q | TUI beenden |
| 1/2/3 | Tabs wechseln (Dashboard / Logs / Install) |
Logs-Tab: g nach oben springen, G nach unten springen, x Logs löschen.
Geräte-Dialog: k ausgewähltes Gerät entfernen, r Liste aktualisieren.
Headless-Modus
Das interaktive TUI ist unter Windows nicht verfügbar und auf einem headless Server nicht gewünscht. Starte stattdessen ohne TUI:
vibe-remote --headless --connector myconnector --password mypassword
Update
vibe-remote update
Nachdem das Update heruntergeladen wurde, drücke u im TUI, um auf die neue Version neu zu starten, ohne die Verbindung zu verlieren.
CLI-Referenz
vibe-remote TUI starten (Standard)
vibe-remote --headless Ohne TUI starten
vibe-remote client Mit einem Remote-Agenten verbinden (Reverse-Modus)
vibe-remote relay Als Relay-Server ausführen
vibe-remote delete-connector Gespeicherten Connector löschen
vibe-remote update Auf neueste Version aktualisieren
vibe-remote version Version anzeigen
vibe-remote help Hilfe anzeigen