AI Pilot im Terminal

Im Terminal-Tab arbeitet AI Pilot in der Shell, die du auf einem SSH-Server geöffnet hast. Du gibst ihm eine Aufgabe, er führt Befehle in deinem Terminal aus, liest ihre Ausgabe und berichtet dir, was dabei herausgekommen ist. Diese Seite begleitet eine Sitzung vom Öffnen des Panels bis zum Fortsetzen des Gesprächs an einem anderen Tag.

AI Pilot öffnen

• Drücke ⌘J.
• Oder klicke auf AI Pilot in der schmalen Leiste am rechten Fensterrand.
• Oder öffne die Befehlspalette mit ⌘P und wähle die Aktion AI Pilot.
• Oder wähle in der Menüleiste Ansicht → AI Pilot ein-/ausblenden.

Das Panel öffnet sich rechts im Tab. Es teilt sich den Platz mit dem Panel Dateien (⌘B), es ist also immer nur eins von beiden sichtbar. Ziehe den linken Rand des Panels, um es breiter oder schmaler zu machen.

Jeder Tab hat seinen eigenen Chat; AI Pilot sieht in einem Tab nicht, was in einem anderen passiert. Ist der Tab in Bereiche geteilt, gehört das Panel zum aktiven Bereich, und jeder Bereich hat seinen eigenen Chat.

Ein Gespräch beginnen

Ein leerer Chat zeigt Womit kann ich helfen?, einen Satz dazu, ob du jeden Befehl bestätigst, und vier Vorschläge:

• Was läuft auf diesem Server? Gib mir einen Überblick.
• Wie ist die Festplatten- und Speicherauslastung?
• Zeige die letzten Fehler in den System-Logs.
• Welche Dienste sind aktiv und welche Ports sind offen?

Ein Klick auf einen Vorschlag schickt ihn ab. Die Vorschläge brauchen eine aktive Verbindung; ist der Tab getrennt, steht im Panel Der Assistent braucht eine aktive Verbindung.

EN

Ein leerer Chat mit vier Vorschlägen

Für eine eigene Aufgabe tippst du in Aufgabe oder Frage eingeben… und drückst Enter. ShiftEnter beginnt eine neue Zeile. Beschreibe das Ziel und alles, was AI Pilot nicht selbst wissen kann: welcher Dienst, welches Verzeichnis, was unangetastet bleiben muss. AI Pilot antwortet in der Sprache, in der du schreibst.

Mitverfolgen

AI Pilot arbeitet in Schritten. Für jeden Schritt wählt er ein Werkzeug – einen Befehl ausführen, den Bildschirm lesen, eine Datei lesen –, und der Schritt erscheint im Chat als Karte. Befehle tippt er in dein Terminal, du siehst sie und ihre Ausgabe also live. Ohne Autopilot wartet jeder Befehl zuerst, bis du auf Ausführen klickst; siehe Freigaben und Sicherheit.

Während AI Pilot arbeitet, steht im Eingabebereich Der Assistent arbeitet…. Eine erledigte Aufgabe endet mit einer kurzen Zusammenfassung.

EN

Jeder Schritt erscheint als Karte; die Antwort endet mit einer Zusammenfassung

Status eines Schritts

Fertige Befehle zeigen außerdem, wie lange sie gedauert haben. Klicke auf eine Karte, um sie aufzuklappen: Du siehst die Ausgabe und bei Befehlen, wie das Ende erkannt wurde – Shell-Integration oder Heuristik.

Woran AI Pilot erkennt, dass ein Befehl fertig ist

Mit Shell-Integration meldet deine Shell das Ende jedes Befehls samt Exit-Code. Ohne sie wartet AI Pilot, bis die Ausgabe einen Moment ruht und der Cursor in einer Zeile steht, die wie dein Prompt aussieht. Das klappt mit gängigen Prompts, auch mit oh-my-zsh, powerlevel10k und Starship, liefert aber keine Exit-Codes.

Das Stecker-Symbol im Kopf des Panels wird grün, wenn die Shell-Integration aktiv ist. Klicke darauf, um zu sehen, wie du sie einrichtest, oder um sie nur für die aktuelle Sitzung einzuschalten.

Interaktive Programme und lange Befehle

Manche Befehle laufen lange oder warten auf eine Eingabe: eine lange Installation, eine [y/N]-Frage, ein Pager, ein Vollbildprogramm. Meldet ein Befehl läuft noch oder Zeitlimit, liest AI Pilot den sichtbaren Bildschirm, um zu sehen, was los ist. Dann kann er Text und Tasten an das Programm schicken – zum Beispiel y und Enter, Ctrl+C, Escape, Tab oder die Pfeiltasten. Tasten zu senden braucht wie ein Befehl deine Freigabe, außer der Autopilot ist an.

AI Pilot bevorzugt nicht interaktive Optionen wie -y oder --no-pager, deshalb kommt das selten vor. Über den Bildschirm bekommt er auch mit, was du selbst im Terminal gemacht hast.

Was AI Pilot über das System weiß

Direkt nach dem Aufbau einer SSH-Verbindung führt kaiport über einen separaten Kanal eine kurze Prüfung aus. In deinem Terminal erscheint davon nichts. Sie sammelt:

• Kernel, Betriebssystem und Distribution,
• Hostname, Benutzer und Gruppen, Login-Shell,
• ob sudo ohne Passwort funktioniert, eines braucht oder gar nicht installiert ist,
• die vorhandenen Paketmanager (apt-get, dnf, yum, pacman, zypper, apk, brew, nix-env, pkg),
• gängige Werkzeuge wie systemctl, docker, podman, kubectl, git, python3, node, nginx, Apache, Caddy, mysql, psql, redis-cli und tmux,
• Zahl der CPUs, Arbeitsspeicher, Belegung des Root-Dateisystems und Uptime.

AI Pilot bekommt diese Zusammenfassung mit jeder Anfrage und muss die Prüfungen deshalb nicht in deinem Terminal ausführen.

Dateiänderungen prüfen

Will AI Pilot eine Datei ändern, steht auf der Karte Der Assistent möchte diese Datei ändern. (oder … anlegen.) und der Knopf Änderung ansehen. Er zeigt die Änderung wie git diff: entfernte Zeilen rot mit -, neue grün mit +.

• Übernehmen schreibt die Änderung.
• Ablehnen … lässt dich eine Notiz mitgeben, etwa „den alten Port behalten und nur den neuen location-Block ergänzen“. AI Pilot bekommt deinen Hinweis und schlägt eine neue Änderung vor.

Dateien, die der SSH-Benutzer nicht schreiben darf, etwa unter /etc, schreibt AI Pilot über sudo im Terminal; sie behalten Besitzer und Rechte. Fragt sudo nach dem Passwort, tippst du es dort ein. Änderungen an Dateien, die dich vom Server aussperren können – sudoers, sshd_config, fstab, Netzwerkkonfiguration, authorized_keys –, zeigen eine Warnung und warten immer auf deinen Klick, auch im Autopilot.

Plan-Modus

Für größere Aufgaben in SSH-Tabs lässt du AI Pilot zuerst planen. Klicke im Eingabebereich auf Plan oder drücke ⇧Tab im Chat und beschreibe die Aufgabe. AI Pilot sieht sich mit Befehlen um, die nur lesen, und schlägt eine Todo-Liste vor; Befehle, die etwas ändern würden, laufen beim Planen nicht.

1. Prüfe die Schritte. Ändere ihren Text, sortiere sie um, nutze Schritt entfernen oder Schritt hinzufügen.
2. Passt es noch nicht? Überarbeiten … schickt eine Notiz, etwa „Port 80 offen lassen“, und du bekommst eine neue Version des Plans. Verwerfen verwirft ihn.
3. Wähle, ob AI Pilot Vor jeder Änderung und jedem Befehl fragen soll, und klicke auf Plan starten.

Während der Plan läuft, werden die Schritte live abgehakt, jeweils mit den Befehlen und Dateiänderungen, die dazu gehörten. Pausieren, Fortsetzen und Abbrechen steuern den Lauf; während der Pause kannst du die offenen Schritte bearbeiten. Stellt AI Pilot fest, dass ein weiterer Schritt nötig ist, schlägt er ihn vor, und du bestätigst ihn. Der Tab zeigt den Fortschritt, während der Plan im Hintergrund läuft.

Server-Ansichten

Fragst du nach dem Zustand eines Servers – „Welche Container laufen?“, „Wie voll sind die Platten?“ –, kann AI Pilot in SSH-Tabs mit einer interaktiven Ansicht statt mit Text antworten:

Tabellen lassen sich sortieren und filtern, Aktualisieren lädt die Daten neu. Das Sammeln einer Ansicht liest nur und läuft im Hintergrund, nicht in deinem Terminal. Ein Knopf wie Neu starten zeigt zuerst den genauen Befehl (Diesen Befehl ausführen?). Bestätigst du, läuft er im Terminal des Tabs wie ein Befehl von AI Pilot, mit den Befehlslisten der Verbindung und einem Eintrag im KI-Protokoll, und AI Pilot erfährt das Ergebnis.

Dieselben Ansichten öffnest du auch ohne AI Pilot: in der Befehlspalette ⌘P, Gruppe Ansicht, für den aktiven SSH-Tab.

Rückfragen von AI Pilot

Liegt eine Entscheidung bei dir – welcher von mehreren Diensten, welche Website, welche Version –, fragt AI Pilot nach. Die Rückfrage erscheint als Karte mit Wartet auf Antwort, bis zu fünf Antwortvorschlägen als Knöpfe und dem Feld Eigene Antwort… (Your own answer…). Klicke auf einen Vorschlag oder tippe eine eigene Antwort und schicke sie mit Enter ab.

AI Pilot macht mit deiner Antwort weiter. Klickst du stattdessen auf Stoppen, gilt die Rückfrage als unbeantwortet.

Antworten, Überlegungen und Code

AI Pilot schreibt seine Antworten in Markdown, mit Überschriften, Listen, Tabellen und Code. Teilt das Modell seine Überlegungen, erscheinen sie als zugeklappter Block Überlegung (Reasoning); klicke darauf, um mitzulesen.

Codeblöcke haben einen Knopf Kopieren. Shell-Codeblöcke haben zusätzlich Ins Terminal einfügen (Insert into terminal): Damit steht der Code an deinem Prompt, ohne dass Enter gedrückt wird – du kannst ihn also prüfen, bevor du ihn ausführst.

Dateien anhängen

Du kannst AI Pilot Dokumente zum Arbeiten mitgeben, etwa ein Log, eine Konfigurationsdatei, eine Tabelle oder ein PDF-Handbuch.

• Klicke im Eingabebereich auf die Büroklammer (Datei anhängen) oder
• ziehe Dateien auf den Eingabebereich; er zeigt dann Dateien hier ablegen, um sie anzuhängen.

Eine Datei darf bis zu 25 MB groß sein. kaiport zieht den Text heraus – jedes Tabellenblatt wird zu einer CSV-Tabelle – und schickt ihn mit deiner Nachricht; die Originaldatei wird nicht gesendet. Text mit mehr als 120.000 Zeichen wird abgeschnitten, und der Anhang zeigt gekürzt. Bei alten .doc-Dateien kann kaiport nur reinen Text retten, die Extraktion kann also unvollständig sein.

Anhänge erscheinen als kleine Kärtchen über dem Eingabefeld. Mit dem × entfernst du einen vor dem Senden wieder.

Auswahl erklären oder Fehler beheben

Markiere Text im Terminal und klicke mit der rechten Maustaste darauf. Neben Kopieren bietet das Menü:

• Auswahl erklären (KI) – AI Pilot soll die markierte Ausgabe erklären.
• Fehler beheben (KI) – AI Pilot soll die Ursache des markierten Fehlers finden und ihn beheben.

Beides öffnet das AI-Pilot-Panel mit einer vorbereiteten Nachricht, die die Auswahl enthält. Gesendet ist noch nichts: Ergänze bei Bedarf Details und drücke dann Enter.

Das Panel Dateien funktioniert genauso: KI zu dieser Datei fragen in der Zeile einer Datei bereitet die Bitte vor, die Datei anzusehen und zu erklären, was sie macht.

Stoppen, neu anfangen und später weitermachen

• Stoppen – während AI Pilot arbeitet, wird der Senden-Knopf zum Stopp-Knopf. Er beendet die Anfrage; Schritte, die auf eine Freigabe warten, und offene Rückfragen gelten dann als abgelehnt. Ein Befehl, der schon im Terminal läuft, läuft weiter: Drücke ⌃C im Terminal, um ihn abzubrechen.
• Neuer Chat – das Papierkorb-Symbol im Kopf des Panels leert das Gespräch und seine Token-Zähler. Modell und Autopilot-Einstellung des Tabs bleiben erhalten.
• Später weitermachen – kaiport speichert das Gespräch nach jeder Anfrage, pro Verbindung. Öffnest du dieselbe Verbindung wieder, auch nach einem Neustart von kaiport, zeigt das Panel das letzte Gespräch, und AI Pilot macht damit weiter. kaiport behält das jeweils letzte Gespräch von bis zu 30 Verbindungen mit jeweils bis zu 120 Nachrichten. Neuer Chat löscht auch das gespeicherte Gespräch dieser Verbindung.

Modell und Autopilot pro Chat

Die Werkzeugleiste unter dem Kopf des Panels hat drei Bedienelemente:

• Modellauswahl – wechselt das Modell für den Chat dieses Tabs. Sie bietet die Modelle an, die in den Einstellungen geladen wurden, siehe AI Pilot einrichten.
• Kontext & Tokens – ein Ring, der zeigt, wie voll das Kontextfenster des Modells ist, siehe Kontext, Tokens und Datenschutz.
• Autopilot – ist er an, laufen Befehle ohne Rückfrage; gefährliche Befehle fragen trotzdem. Neue Tabs starten mit dem Standard aus den Einstellungen. Schaltest du den Autopilot ein, während ein Schritt auf Freigabe wartet, läuft dieser Schritt los – außer er ist gefährlich.

sudo und Passwörter

AI Pilot fragt nie im Chat nach einem Passwort. Will ein Befehl wie sudo eines haben, bittet AI Pilot dich, es im Terminal einzutippen:

1. Klicke ins Terminal.
2. Tippe das Passwort und drücke Enter.
3. AI Pilot liest den Bildschirm und macht weiter. Hat er seine Antwort schon beendet, schreib ihm im Chat, dass du das Passwort eingegeben hast.

Dank der Prüfung beim Sitzungsstart weiß AI Pilot meist schon vorher, ob sudo auf diesem System ein Passwort braucht.