Dokumentation

1. Desktop-App installieren

Gehen Sie zur Downloadseite, um den Windows- / macOS- / Linux-Client zu holen und zu installieren. Nach dem Start gibt es oben zwei ständige Einstiege: Home (Assets und Sitzungen) und Deck (der Betriebsassistent). Alltägliche Assets liegen in der Home-Seitenleiste: Hosts, Schlüssel, Weiterleitung, Jobs und Einstellungen.

• In den Einstellungen können Sie das Standard-Lokalterminal (dort laufen Assistent und lokale Shell) und die Systemsprache ändern.
• Die Desktop-App erfordert ein Website-Konto. Free-Konten behalten alle lokalen Verbindungs- und Verwaltungsfunktionen; Cloud-Synchronisierung, Überwachung und KI-Ausführung erfordern Pro.

2. Anmelden – Cloud-Modelle funktionieren sofort

Assistent, Befehlsvorschläge und Überwachungserkundung nutzen standardmäßig Cloud-Modelle: anmelden und loslegen, ohne Modellschlüssel zu konfigurieren.

1. Melden Sie sich auf der Anmeldeseite mit E-Mail oder Google / GitHub an und wählen Sie dann "Dieses Gerät autorisieren"; die Desktop-App übernimmt das aktuelle Konto.
2. Die Cloud-Modellliste wird mit Ihrem Konto geliefert und kann direkt im Modellwähler der Deck-Eingabeleiste gewählt werden.
3. Die Cloud-Modellnutzung zählt gegen Ihr Abonnementkontingent: zuerst das Monatskontingent, dann Ihr Guthaben; Free erhält ebenfalls ein begrenztes Cloud-Kontingent und eine Vorschlagsanzahl pro Monat (nur Basismodelle).
4. Prüfen Sie den aktuellen Status, die Monatskontingentnutzung und das Guthaben unter Konto → Abonnement.

Abonnieren Sie Pro, um Cloud-Synchronisierung, Überwachung, KI-Ausführung und den vollständigen Cloud-Modellkatalog freizuschalten. Kauf in der Desktop-App; Verlängerungen verwaltet der App Store. Siehe Preise.

3. Geräte und Schlüssel registrieren

Sitzungen, Assistent, Dateiübertragung und Weiterleitung teilen einen Asset-Satz. Legen Sie zuerst "mit wem und womit verbinden" ins Inventar, damit Sie Verbindungsdetails nie wieder zusammensetzen müssen.

Einen Schlüssel erstellen (zuerst empfohlen)

1. Home → Schlüssel → Neuer Schlüssel.
2. Fügen Sie den öffentlichen Schlüssel und den privaten Schlüssel ein; ergänzen Sie die Passphrase, falls vorhanden; fügen Sie das Zertifikat ein, wenn Sie eines brauchen.
3. Nur das OpenSSH-Format wird unterstützt; wandeln Sie PuTTY-PPK-Dateien zuerst nach OpenSSH um.

Ein Gerät hinzufügen

1. Home → Hosts → Gerät hinzufügen (der Leerzustand fordert ebenfalls "Noch keine Geräte, zum Hinzufügen klicken").
2. Basisinformationen: Name, Host, Typ und Gruppe. Der Typ beeinflusst Befehlsvorschläge und einen Teil der geräteseitigen Interaktion, wählen Sie ihn daher sorgfältig.
3. Füllen Sie nach Bedarf SSH (Port 22 standardmäßig, Benutzername, Passwort oder Schlüssel), Telnet (Port 23 standardmäßig) und/oder RDP (Domäne, Auflösung, Sicherheitsschicht usw.) aus.
4. SSH hat zusätzliche Optionen für Sitzungswiederverwendung, SSH-Agent und Authentifizierungsmethode; Telnet hat Eingabeaufforderungserkennung und Befehls-Echo-Prüfung; RDP hat Farbtiefe, Tastaturlayout und Laufwerksumleitung.
5. Speichern, oder direkt Speichern und verbinden.

Passwörter, Schlüssel und andere sensible Assets bleiben in lokalen Daten; die Anmeldung auf der Website lädt sie nie als Cloud-Inventar hoch.

4. Eine Sitzung öffnen

Bestätigen Sie, dass das Ziel erreichbar ist, bevor Sie es dem Assistenten übergeben. Klicken Sie eine Host-Karte an und wählen Sie das zu öffnende Protokoll.

• SSH / Telnet: öffnet einen Terminalbereich. Die erste Verbindung fordert Sie auf, den Host-Fingerprint zu bestätigen; ein geänderter Fingerprint löst einen Alarm aus, und Sie können ablehnen, einmal vertrauen oder dauerhaft vertrauen.
• SFTP: nutzt dieselbe Identität wie SSH und öffnet die zweispaltige Dateiansicht.
• RDP: betritt den Windows-Desktop mit gemeinsamer Zwischenablage und lokalen Laufwerken.
• Lokale Shell: wählen Sie ein Terminal aus der Host-Werkzeugleiste (Eingabeaufforderung / PowerShell / WSL usw., je nachdem, was auf Ihrem Rechner gefunden wird).
• Nach einer Trennung Erneut verbinden nutzen; das + oben öffnet eine neue Registerkarte, um letzte Verbindungen erneut aufzurufen.
• Passen Sie Terminaleinstellungen (Schrift, Thema) und Suchen im Bereich an, ohne die Sitzung zu unterbrechen.

Registerkarten können zum Neuordnen gezogen oder zu geteilten Ansichten zusammengeführt werden: zusammenführen, wenn Sie zwei Geräte nebeneinander brauchen, zurück zur Registerkartenleiste ziehen, wenn Sie sich konzentrieren wollen.

5. Dateiübertragung und Tunnel

Zweispaltige Dateien

Öffnen Sie SFTP in einer Sitzung, um lokal und remote nebeneinander zu sehen. Häufige Aktionen: öffnen, ins Zielverzeichnis kopieren, neuer Ordner/neue Datei, umbenennen, löschen, Berechtigungen ändern, versteckte Dateien anzeigen, Pfad kopieren. Bei Konflikten überspringen oder überschreiben, wie aufgefordert; der Fortschritt bleibt am unteren Rand des Bereichs.

Tunnel und Weiterleitung

1. Home → Weiterleitung → Neue Weiterleitung.
2. Wählen Sie einen Typ: Lokal (ein lokaler Port in die Zielumgebung), Remote (ein Remote-Port zurück auf diese Seite) oder Dynamisch (SOCKS5-Proxy).
3. Füllen Sie Name, Port, Bind-Adresse, Zielhost und Adresse aus und schalten Sie mit Weiterleitung starten um. Zustände sind idle, running oder error.

Dateien und Weiterleitung hängen nicht vom Assistenten ab und können allein genutzt werden.

6. Den Betriebsassistenten nutzen (Deck)

Wechseln Sie oben zu Deck. Links liegen neuer Chat, Skills, MCP-Server, letzte Chats und Gerätereferenzen; in der Mitte liegen Unterhaltung und Werkzeugausführung.

Ihre erste Unterhaltung

1. Stellen Sie sicher, dass in der Werkzeugleiste ein Modell gewählt ist; Cloud-Modelle sind direkt nach der Anmeldung verfügbar.
2. Lassen Sie den Genehmigungsmodus auf Jedes Mal fragen (Standard): Sie klicken für jede Aktion auf Erlauben oder Überspringen.
3. Nutzen Sie das + links in der Eingabeleiste, um Geräte, Gruppen, Skills oder Bilder hinzuzufügen, oder ziehen Sie aus Gerätereferenzen. Referenzen werden zu Kontext-Chips, damit der Assistent den Umfang kennt.
4. Beschreiben Sie das Ziel in natürlicher Sprache. Beginnen Sie mit einer schreibgeschützten Inspektion, etwa CPU, Datenträger und Status wichtiger Schnittstellen.
5. Wenn eine Aktion auf Bestätigung wartet, wählen Sie Erlauben oder Überspringen; für wiederholte ähnliche Befehle nutzen Sie "Immer zulassen", um bei demselben Muster nicht unterbrochen zu werden.

Genehmigungsmodi

• Jedes Mal fragen: Sie klicken für jede Aktion auf Erlauben oder Überspringen.
• Für mich genehmigen: Eine Genehmigung wird nur für als riskant erkannte Aktionen angefordert.
• Alles erlauben: keine Aufforderungen pro Schritt, aber gefährliche Befehle werden weiterhin blockiert; die Gefahrwortliste ist anpassbar. Nutzen Sie diese Stufe erst, wenn Sie den Ablauf kennen.

7. Eingebaute Werkzeuge

Der Assistent bringt 39 eingebaute Werkzeuge mit, die Geräteausführung, Dateien und Dokumente, Asset-Nachschlag, Codesuche, Webzugriff und Überwachung abdecken. Ändernde Aktionen gehen zuerst durch den Genehmigungsmodus; Abfragen laufen direkt.

Geräteausführung

• Lokaler Befehl: führt Befehle auf diesem Rechner aus; lange Aufgaben wechseln in den Hintergrund, und Sie können Prozesse auflisten, die Ausgabe lesen oder jederzeit beenden.
• SSH / Batch-SSH: führt Befehle auf einem oder vielen registrierten Geräten aus, im Batch-Modus parallel.
• Telnet: führt Befehle auf Telnet-Zielen wie Netzwerkgeräten aus.

Dateien und Dokumente

• SFTP-Übertragung: Hoch- und Herunterladen zwischen diesem Rechner und Geräten.
• Dateien lesen / bearbeiten: lokale und remote Textdateien lesen und exakte Ersetzungen anwenden.
• Dokumentverarbeitung: PDFs lesen, Excel und Word lesen und schreiben und Inspektionsberichte direkt erzeugen.

Assets und Kontext

• Geräte / Gruppen / Skills finden: Inventar-Assets jederzeit als Kontext nachschlagen.
• Chatverlauf und Aufgabenliste: vergangene Unterhaltungen durchsuchen und mehrstufige Arbeit als Checkliste halten.

Code und Referenzen

• Code-Werkzeuge: Repository-Strukturkarte, Inhaltssuche, Symboldefinitionen und Referenzen.
• Explore-Teilagent: schreibgeschützte parallele Erkundung großer Verzeichnisse oder langer Dokumente, zusammengefasst zurück in den Hauptchat.
• Websuche / Seite abrufen: externe Referenzen suchen und Seiteninhalt abrufen; Websuche gehört zu Ihrem Konto.

Überwachung und Skills

• Metrik lesen/schreiben: Geräteüberwachungsmetriken lesen und nach Bestätigung Metriken hinzufügen oder ändern.
• Skill-Destillation: den aktuellen Ablauf als neuen Skill schreiben oder einen bestehenden aktualisieren (erfordert Bestätigung).

Typische Szenarien

• Inspektion: CPU, Datenträger und Status wichtiger Schnittstellen über Geräte prüfen und eine lesbare Schlussfolgerung erzeugen.
• Änderung: eine Konfigurationsdatei bearbeiten und den Dienst neu starten, Schritt für Schritt bestätigt.
• Übertragung: Remote-Protokolle paketieren, zurückholen, analysieren und einen Bericht ausgeben.
• Fehlerbehebung: Websuche und Dokumentlesen kombinieren, um die Quelle eines Fehlers zu finden.

8. Skills

Ein Skill ist eine wiederverwendbare Markdown-Eingabe (Name + einzeilige Beschreibung + Körper), gespeichert in der lokalen Skill-Bibliothek und in der Cloud-Sicherung enthalten.

• Erstellen: einen unter Deck → Skills schreiben; einen aus vergangenen Unterhaltungen mit KI destillieren; oder den Assistenten nach Ihrer Bestätigung einen neuen Skill speichern lassen.
• Nutzen: "+ → Skills" in der Eingabeleiste, oder direkt referenzieren. Einmal referenziert bleibt er für den Durchlauf aktiv, sodass Folgefragen keine erneute Referenz brauchen.
• Weiterentwickeln: der Assistent kann Skill-Inhalt während der Nutzung verfeinern; Änderungen erfordern ebenfalls eine Bestätigung.

9. MCP-Server

Der Assistent kann sich mit MCP-Servern (Model Context Protocol) verbinden, um externe Werkzeuge in dieselbe Unterhaltung zu holen.

• Transporte: stdio (gestartet durch einen lokalen Befehl) und Streamable HTTP (Remote-URL).
• Konfigurieren: Deck → MCP-Server → Hinzufügen; Befehl, Argumente und Umgebungsvariablen ausfüllen oder eine JSON-Konfiguration zum Import einfügen.
• Aktivierung: einmal aktiviert, treten seine Werkzeuge dem Werkzeugsatz des Assistenten bei; eingebaute Werkzeuge gewinnen bei Namenskollisionen. Die Liste zeigt Status und Werkzeuganzahl jedes Servers.
• Sicherheit: jeder MCP-Werkzeugaufruf geht durch denselben Genehmigungsmodus wie eingebaute Werkzeuge.

Aufrufe tun nichts, solange ein Server nicht bereit ist (Prozess nicht gestartet oder URL unerreichbar); prüfen Sie zuerst seinen Status in der Liste.

10. Terminal-Befehlsvorschläge

Schalten Sie Befehlsvorschläge unter Einstellungen → KI-Fähigkeiten ein, und Kandidaten erscheinen neben dem Cursor, während Sie in lokalen oder remote Terminals tippen. Das Vorschlagsmodell wird in der Cloud konfiguriert; lokal wählen Sie nur die Kandidatenanzahl.

• Vorschau und Liste nebeneinander; Tab zum Übernehmen, Pfeiltasten zum Wechseln; schließen Sie das Panel, um weiterzutippen.
• Das Panel nimmt eine Absicht in natürlicher Sprache entgegen: Eingabe drücken, um Kandidaten zu erzeugen.
• Kandidaten folgen der aktuellen Sitzung und dem Gerätetyp und passen zum Dialekt des Moments.
• Wenn keine Vorschläge erscheinen: prüfen Sie, dass der Schalter an ist, Sie angemeldet sind und der aktuelle Bereich ein Sitzungstyp ist, der Vorschläge unterstützt.

11. Überwachung und Entdeckung

Pfad: Home → Jobs. Zwei Registerkarten: Überwachung und Entdecken.

Überwachung

1. Klicken Sie auf Neue Aufgabe, markieren Sie die zu beobachtenden Hosts und bestätigen Sie.
2. Metriken auf der Gerätekarte ansehen; Details öffnen, um Name, Protokoll, Intervall, Parsing, Alarme und KI-Eskalation zu konfigurieren.
3. Optionen der KI-Eskalation: aus, nur Analyse (L1), Reparatur mit Bestätigung (L2). L2 geht weiterhin durch die Assistentenbestätigung und ändert nie still die Konfiguration.
4. Nutzen Sie "Jetzt erfassen", um zu prüfen, dass eine einzelne Metrik den erwarteten Wert liefert.

Entdecken

1. Wählen Sie unter Einstellungen → KI-Fähigkeiten ein Erkundungsmodell (Cloud-Modelle sind nach der Anmeldung verfügbar).
2. Starten Sie zurück in Überwachung Metriken automatisch entdecken auf einem Gerät; der Prozess zeigt sich als Erkunden.
3. Prüfen Sie die Erkundungszusammenfassung und die Kandidaten auf der Registerkarte Entdecken; jeder ist ausstehend oder übernommen. Markieren und Übernehmen klicken, bevor sie in die Routineerfassung eingehen.

Die Erkundung schlägt nur Kandidaten vor und startet nie von selbst die Erfassung; Sie entscheiden, was in die Routine kommt.

12. Protokollspezifikationen

Implementierungsdetails für SSH, Telnet, RDP, SFTP und die lokale Shell – Authentifizierungsmatrix, Optionsaushandlung, Kanalfähigkeiten, Vertrauensmodell und Systemanforderungen – sind auf der Seite der technischen Spezifikationen gesammelt und bleiben mit der Desktop-App synchron.

13. Eigene Modelle (erweitert, optional)

Standardmäßig nicht nötig: Cloud-Modelle funktionieren nach der Anmeldung. Konfigurieren Sie dies nur, wenn Sie Ihren eigenen Modelldienst nutzen wollen.

1. Öffnen Sie Home → Einstellungen → Modelle → Modell hinzufügen.
2. Wählen Sie eine Anbieter-Vorlage (OpenAI, Anthropic, DeepSeek, Ollama, OpenRouter, Moonshot, Qwen, Zhipu) oder eine eigene Basis-URL.
3. Geben Sie den API-Schlüssel und den Modellnamen ein, speichern Sie, und er wird in der Deck-Eingabeleiste auswählbar.

Eigene Modellschlüssel werden nur auf diesem Rechner gespeichert.

14. Sicherheit und Standards

• Der Assistent steht standardmäßig auf Jedes Mal fragen. Gewöhnen Sie sich mit schreibgeschützten Aufgaben an den Werkzeugaufrufrhythmus, bevor Sie die Grenze erweitern.
• "Immer zulassen" gilt nur für ähnliche Befehle; es ist keine globale Stummschaltung.
• "Alles erlauben" blockiert weiterhin Befehle auf der Gefahrwortliste, die Sie anpassen können.
• Host-Fingerprints müssen bei der ersten Verbindung bestätigt werden; wenn einer sich ändert, prüfen Sie, dass die Änderung erwartet ist, bevor Sie wählen, wie Sie ihr vertrauen.
• Gerätepasswörter, Schlüsselmaterial und eigene Modellschlüssel liegen innerhalb der lokalen Vertrauensgrenze – schützen Sie den Computer, auf dem Termini läuft.
• Automatische Alarmreparatur (L2) folgt Ihrer Bestätigungsrichtlinie genau wie jede Schreibaktion des Assistenten.

Eine vollständigere Beschreibung finden Sie auf der Funktionenseite; folgen Sie nach der Installation den Schritten 2 → 3 → 4 → 6 oben, um Ihre erste Schleife abzuschließen.