Sitzungen & Verlauf

Wie Sitzungen funktionieren

Jedes Mal, wenn Sie YeePilot verwenden, wird Ihr Gespräch automatisch als Sitzung gespeichert. Sitzungen erfassen Ihre Anfragen, KI-Antworten, Befehlspläne, Genehmigungsentscheidungen und Ausführungsausgaben. Sie müssen nie manuell speichern -- es geschieht im Hintergrund.

Wenn Sie YeePilot starten, wird Ihre letzte Sitzung fortgesetzt. Wenn Sie lieber neu beginnen möchten, verwenden Sie den /new-Befehl.

Sitzungen verwalten

Neue Sitzung erstellen

> /new

Dies erstellt eine frische Sitzung mit einem sauberen Gesprächsverlauf. Ihre vorherige Sitzung bleibt erhalten und kann später fortgesetzt werden.

Alle Sitzungen auflisten

> /sessions

Dies zeigt eine Liste Ihrer gespeicherten Sitzungen mit ihren Namen, Erstellungsdaten und Nachrichtenanzahlen an. Wählen Sie eine Sitzung aus der Liste, um zu ihr zu wechseln.

Sessions:
  1. nginx-troubleshooting     (12 messages, 2h ago)
  2. database-migration        (8 messages, yesterday)
  3. firewall-setup            (23 messages, 3 days ago)
 
Switch to: _

Sitzung umbenennen

Standardmäßig werden Sitzungen automatisch benannt. Geben Sie ihnen aussagekräftige Namen, um sie später wiederzufinden:

> /rename nginx-troubleshooting

Sie können auch ohne Argumente umbenennen und werden dann nach einem Namen gefragt:

> /rename
Enter new name: prod-server-audit

Sitzung exportieren

Exportieren Sie die aktuelle Sitzung als Klartextprotokoll:

> /export

Dies speichert das vollständige Gespräch -- Ihre Anfragen, KI-Antworten, vorgeschlagene Befehle und Ausführungsausgaben -- als lesbare Textdatei. Exporte sind nützlich für Dokumentation, Vorfallberichte oder zum Teilen mit Kollegen.

Kontextfensterverwaltung

KI-Modelle haben ein begrenztes Kontextfenster -- die Textmenge, die sie gleichzeitig berücksichtigen können. Wenn Ihr Gespräch wächst, nähert es sich diesem Limit. YeePilot handhabt dies automatisch durch Kontextkomprimierung.

Wie die Komprimierung funktioniert

Wenn das Kontextfenster etwa 80 % Kapazität erreicht, löst YeePilot eine automatische Komprimierung aus:

1. Die ältesten 80 % der Nachrichten im Gespräch werden ausgewählt
2. Diese Nachrichten werden in eine kompakte Zusammenfassung verdichtet
3. Die Zusammenfassung ersetzt die Originalnachrichten
4. Die neuesten 20 % der Nachrichten bleiben intakt

Dieser Vorgang ist nahtlos. Sie müssen keine Maßnahmen ergreifen, und das Gespräch wird normal fortgesetzt. Die KI behält den wesentlichen Kontext aus dem früheren Gespräch bei, während Platz für neue Interaktionen geschaffen wird.

Was die Komprimierung bewahrt

Die Zusammenfassung behält:

• Wichtige Entscheidungen und Ergebnisse
• Wichtige Dateipfade und Konfigurationswerte
• Fehlermeldungen und deren Lösungen
• Das Gesamtziel der Sitzung

Was natürlich verloren geht:

• Exakte Befehlsausgaben vom Anfang der Sitzung
• Ausführliche Zwischenschritte
• Explorative Befehle, die zu nichts geführt haben

Wenn Sie auf exakte Ausgaben von früher in einer langen Sitzung zurückgreifen müssen, erwägen Sie, die Sitzung zu exportieren, bevor die Komprimierung eintritt, oder starten Sie eine neue Sitzung für die nächste Aufgabe.

Token-Verfolgung

YeePilot verfolgt den Token-Verbrauch für jede Sitzung und gibt Ihnen Einblick in API-Nutzung und Kosten.

Token-Verbrauch anzeigen

Drücken Sie Ctrl+S während einer Sitzung, um das Statistik-Panel zu sehen, das Folgendes enthält:

• Prompt-Token -- Token, die an die KI gesendet werden (Ihre Nachrichten plus Kontext)
• Completion-Token -- Token, die von der KI generiert werden
• Gesamt-Token -- Kombinierter Verbrauch für die Sitzung
• Geschätzte Kosten -- Berechnet aus der Token-Preisgestaltung Ihres Modells

Token-Kosten verstehen

Der Token-Verbrauch variiert erheblich basierend auf:

• Gesprächslänge -- Längere Sitzungen verbrauchen mehr Token pro Nachricht, da der vollständige Verlauf als Kontext gesendet wird
• Agentenmodus -- Mehrstufige Aufgaben verbrauchen aufgrund wiederholten Kontexts und Werkzeugaufrufen mehr Token
• Denkmodus -- Höhere Denkstufen verbrauchen mehr Completion-Token
• Dateikontext -- Mit /file geladene Dateien erhöhen den Prompt-Token-Verbrauch

Kosten niedrig halten

• Verwenden Sie kostenlose OpenRouter-Modelle für Routineaufgaben
• Starten Sie neue Sitzungen mit /new anstatt sehr lange Gespräche fortzusetzen
• Entfernen Sie Dateien aus dem Kontext mit /unfile, wenn sie nicht mehr benötigt werden
• Verwenden Sie niedrigere Denkmodi (/think low) für einfache Aufgaben
• Überwachen Sie den Verbrauch mit Ctrl+S regelmäßig

Sitzungsspeicher

Sitzungen werden lokal in ~/.yeepilot/sessions/ gespeichert. Jede Sitzung ist eine JSON-Datei, die den vollständigen Gesprächsverlauf und Metadaten enthält. Diese Dateien sind nur für Ihr Benutzerkonto zugänglich.

Sitzungen werden nie an YeePilots Server gesendet. Sie verbleiben vollständig auf Ihrem Rechner. Die einzigen Daten, die Ihr System verlassen, sind das, was Sie als Teil des normalen Prompt/Antwort-Ablaufs an Ihren gewählten KI-Anbieter senden.

Praktische Workflows

Aufgabenbasierte Sitzungen

Erstellen Sie eine neue Sitzung für jede eigenständige Aufgabe:

> /new
> /rename firewall-audit-2026-02
> Check all iptables rules and identify any overly permissive entries

Dies hält Ihre Sitzungen organisiert und macht sie leicht wiederzufinden.

Vorfallreaktion

Während eines Vorfalls wird die Sitzung zu einem Echtzeit-Protokoll Ihrer Untersuchung:

1. Neue Sitzung starten: /new
2. Benennen: /rename incident-2026-02-27-api-outage
3. Diagnose mit YeePilot durcharbeiten
4. Bei Lösung exportieren: /export

Das exportierte Protokoll dient als Vorfallbericht, der genau zeigt, was geprüft, was gefunden und welche Maßnahmen ergriffen wurden.

Arbeit fortsetzen

Am nächsten Tag zu einer Aufgabe zurückkehren:

> /sessions

Wählen Sie die relevante Sitzung. Die KI hat den vollständigen Gesprächskontext und kann dort weitermachen, wo Sie aufgehört haben.