Hilfe & FAQ
Alles für den Einstieg in TermBuddy, dazu Antworten auf die häufigsten Fragen.
Schnellstart
1. Server hinzufügen
Öffnen Sie TermBuddy, tippen Sie auf „Server hinzufügen“ und geben Sie Adresse, SSH-Port und Benutzernamen mit Passwort oder SSH-Schlüssel ein. Mehr braucht es nicht: TermBuddy verbindet sich per SSH und installiert seinen kleinen Helfer automatisch auf dem Server.
2. Buddy anlegen
Ein Buddy ist eine dauerhafte Sitzung auf Ihrem Server, dargestellt als Chat. Legen Sie einen Terminal-Buddy an, um Befehle wie Nachrichten zu senden, oder einen KI-Buddy (Claude Code, Codex oder Gemini), der in einem von Ihnen gewählten Projektverzeichnis arbeitet.
3. Loschatten
Senden Sie Befehle oder Anweisungen; die Ausgabe kommt als Antwort zurück. Schließen Sie die App jederzeit: Lange Aufgaben laufen auf dem Server weiter, und Sie bekommen eine Push-Benachrichtigung, wenn sie fertig sind.
Häufige Fragen
Was genau ist TermBuddy?
TermBuddy macht aus entfernten Servern Chat-Unterhaltungen auf iPhone und Mac. Terminal-Sitzungen und KI-Agenten (Claude Code, Codex, Gemini CLI) werden zu „Buddies“, denen Sie schreiben. Die Sitzungen bleiben auf dem Server bestehen, die Arbeit läuft also weiter, während das Telefon in der Tasche steckt.
Ist das sicher? Welche Ports muss ich öffnen?
Nur SSH (meist Port 22), also den Port, den Sie ohnehin nutzen. Der Helfer, den TermBuddy auf Ihrem Server installiert, lauscht ausschließlich auf 127.0.0.1 und ist nie aus dem Internet erreichbar; der gesamte Verkehr läuft durch Ihre SSH-Verbindung. Zugangsdaten liegen im System-Schlüsselbund Ihres Geräts, und nichts läuft über fremde Server.
Was brauche ich auf dem Server?
Einen Linux- oder macOS-Server, auf den Sie sich per SSH verbinden können. Keine manuelle Einrichtung: TermBuddy lädt seinen Helfer hoch und konfiguriert ihn. Für KI-Buddies muss zusätzlich die KI-CLI (z. B. Claude Code) auf dem Server installiert und angemeldet sein; auch dafür gibt es auf der Serverseite einen geführten Installer.
Welche KI-Assistenten werden unterstützt?
Claude Code, OpenAI Codex CLI und Google Gemini CLI. Die KI läuft auf Ihrem Server im gewählten Arbeitsverzeichnis, mit eigener Anmeldung und Abrechnung (z. B. Ihrem Anthropic-Konto). TermBuddy ist die Fernbedienung: Pläne, To-dos, Rückfragen und Ergebnisse erscheinen als Chat-Nachrichten.
Stoppen Befehle, wenn ich die App schließe?
Nein. Die Sitzungen leben auf dem Server. App schließen, Empfang verlieren, Gerät wechseln: Wenn Sie zurückkommen, ist der vollständige Verlauf da. Push-Benachrichtigungen melden, wenn eine lange Aufgabe fertig ist oder fehlschlägt.
Was ist die Memory-Bibliothek (Experience)?
Eine persönliche Wissensbasis aus Vorlieben, Projektnotizen und gelernten Lektionen, die automatisch von Ihrem Mac auf alle Server synchronisiert wird, damit jeder KI-Buddy sie nutzen kann. Vorhandene Claude-Erinnerungen lassen sich mit einem Tipp importieren, und die Funktion „Kategorisieren“ lässt eine KI alles nach Themen sortieren.
Was sind Skills?
Wiederverwendbare Anleitungspakete (Code-Review, systematisches Debugging, TDD, Datenanalyse, wissenschaftliches Schreiben und mehr), die KI-Buddies beibringen, eine Aufgabe gut zu erledigen. Schalten Sie sie im Skills-Tab der Mac-App ein; sie werden automatisch auf alle Server verteilt, und die KI wählt den passenden aus, wenn Ihre Anfrage dazu passt.
Mein Buddy hängt bei „Verarbeitung …“, was tun?
Öffnen Sie den Tab „Server“ und prüfen Sie den Zustand des Servers. Ein Neustart des TermBuddy-Helfers von dort behebt die meisten Fälle; zeigt ein roter Punkt ein Update an, aktualisieren Sie den Helfer. Prüfen Sie außerdem auf der Serverseite, ob die KI-CLI installiert und angemeldet ist.
Ich kann mich nicht mit meinem Server verbinden.
Prüfen Sie zuerst, ob normales SSH aus einem anderen Terminal mit demselben Host, Port, Benutzer und denselben Zugangsdaten funktioniert. Klappt SSH, aber TermBuddy nicht, sehen Sie im Tab „Server“ nach dem Zustand und in das serverseitige Log unter ~/.termbuddy/termbuddy.log.
Wie funktionieren Updates?
Die Apps aktualisieren sich über den App Store. Der Server-Helfer wird aus der App heraus aktualisiert: Ein roter Punkt im Tab „Server“ bedeutet, dass eine neuere Version vorliegt, und ein Tipp installiert sie über SSH.
Welche Daten erheben Sie?
Ihr Gerät spricht direkt mit Ihrem Server, ohne Zwischenstation. Wir sehen niemals Ihre Zugangsdaten, Befehle, Ausgaben oder Dateien. Alle Einzelheiten stehen in der Datenschutzerklärung.
Wo bekomme ich Unterstützung?
Schreiben Sie an atlai@atlai.co.uk oder nutzen Sie „Feedback senden“ in der App. Fehlerberichte mit dem Server-Log (~/.termbuddy/termbuddy.log) helfen besonders.