nessie

Einen Remote-Executor einrichten

Installieren, koppeln und verwalten Sie einen Computer, der mit Nessie-Agenten zusammenarbeitet.

Der Executor verbindet einen Rechner, den Sie kontrollieren, mit Nessie. Installieren Sie ihn unter dem Betriebssystemkonto, dessen Dateien und Programme er verwenden soll. Sie brauchen weder Node.js noch einen Quellcode-Checkout.

macOS

Die CLI erfordert macOS 15 oder neuer auf Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

Für die vollständige Nessie-Desktop-App oder den eigenständigen Executor mit seinem lokalen Berechtigungsfenster:

brew install --cask unlikeotherai/tap/nessie
brew install --cask unlikeotherai/tap/nessie-executor-app

Wählen Sie die Oberfläche, die Sie nutzen möchten. Betreiben Sie je Kopplung genau einen Supervisor. In der Executor-App steuert Einstellungen → Nessie Executor beim Anmelden öffnen den automatischen Start.

Debian und Ubuntu

Verwenden Sie das signierte APT-Repository auf x86_64 mit Debian 12+ oder Ubuntu 22.04+:

sudo apt-get update
sudo apt-get install -y curl ca-certificates
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://packages.nessie.works/nessie-executor.asc | sudo tee /etc/apt/keyrings/nessie-executor.asc >/dev/null
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/nessie-executor.asc] https://packages.nessie.works/apt stable main" | sudo tee /etc/apt/sources.list.d/nessie-executor.list >/dev/null
sudo apt-get update
sudo apt-get install nessie-executor

Fedora, Rocky Linux und AlmaLinux

Verwenden Sie das signierte RPM-Repository auf x86_64 mit Fedora oder Rocky Linux / AlmaLinux 9+:

sudo curl -fsSL https://packages.nessie.works/nessie-executor.repo -o /etc/yum.repos.d/nessie-executor.repo
sudo dnf install nessie-executor

Linux-Hintergrunddienste benötigen systemd. Die Pakete enthalten die Laufzeitumgebung; APT oder DNF installiert Git und tmux als Abhängigkeiten.

Windows-Executor

Installieren Sie den signierten eigenständigen Executor mit WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Öffnen Sie Nessie Executor über das Startmenü oder das Infobereich-Symbol. Neue Teamverbindungen laufen unter Ihrem angemeldeten Windows-Konto. Der Installer stellt außerdem den unabhängigen Supervisor für das Dienstkonto bereit. Interaktive Terminalprogramme laufen nur in einer Benutzersitzungsverbindung, weil dort ihre Anmeldedaten verfügbar sind.

Ein Team koppeln

Führen Sie die CLI mit Ihrem gewöhnlichen Konto aus, ohne sudo:

nessie-executor login --api nessie --workspace "/path/to/work"

Für Ihren eigenen Nessie-Server ersetzen Sie nessie durch dessen HTTPS-API-URL. Team hinzufügen in der Desktop-Executor-App startet denselben Ablauf.

  1. Kopieren Sie den achtstelligen Code, der auf dem Rechner angezeigt wird.
  2. Öffnen Sie in Nessie Admin › Computer › Computer hinzufügen. Fügen Sie den Code ein, wählen Sie Organisation, Team und Zugriffsbereich und prüfen Sie den Fingerabdruck.
  3. Bestätigen Sie auf dem Rechner die angegebene Organisation und das Team.
  4. Prüfen Sie, ob der Executor online ist, sehen Sie sich seine Fähigkeiten in Nessie an und gewähren Sie den vorgesehenen Agenten Zugriff.

Codes laufen nach zehn Minuten ab und funktionieren nur einmal. Wiederholen Sie login oder Team hinzufügen, um ein weiteres Team zu koppeln. Jede Verbindung hat ihren eigenen Maschinenschlüssel, eigene Ordner, eigene Befehlsregeln und einen eigenen Startdienst.

nessie-executor teams
nessie-executor permissions --executor <executor-id>
nessie-executor permissions --executor <executor-id> --allow-all --deny "git push *"
nessie-executor permissions --executor <executor-id> --allow "git *,pnpm *"

Alle Befehle sind standardmäßig erlaubt, vorbehaltlich struktureller Sicherheitsprüfungen; die lokale Sperrliste hat Vorrang vor der Erlaubnisliste. Ordner- und Befehlsberechtigungen werden nur auf diesem Rechner gespeichert und lassen sich nicht über Nessie ändern. Nessie legt fest, welche Personen und Agenten die Verbindung innerhalb ihres Teams nutzen dürfen. Beenden Sie den lokalen Daemon, bevor Sie Berechtigungen ändern, und starten Sie ihn danach wieder.

Agenten können außerdem Codex, Gemini, Claude, eine Shell oder ein anderes installiertes Programm in einem interaktiven Terminal auf diesem Rechner starten, soweit es diese Befehlsregeln zulassen; sonst ist nichts konfiguriert. Solche Programme müssen bereits installiert und unter demselben Konto angemeldet sein; macOS und Linux brauchen tmux. Ein Terminalprogramm hat den Zugriff des Betriebssystemkontos, und sein Ordner ist keine Sandbox. Für eine abgeschottete command.run ist zusätzlich die Gast-Laufzeitumgebung erforderlich.

Start, Status und Updates

Interaktives login aktiviert den automatischen Start, nachdem Sie die Kopplung bestätigt haben. Unter macOS startet ein launchd-Agent dieses Team, wenn Sie sich anmelden. Unter Linux hält ein systemd-Benutzerdienst mit Lingering die Verbindung über Abmeldung und Neustart hinweg aufrecht.

nessie-executor status
nessie-executor enable <executor-id>
nessie-executor disable <executor-id>

disable beendet den Dienst, ohne Kopplung oder Berechtigungen zu löschen. Für eine Sitzung im Vordergrund deaktivieren Sie zuerst dessen Dienst und verwenden dann nessie-executor daemon --executor <executor-id>. Kopplungen, die mit einem expliziten --state-dir angelegt wurden, werden im Vordergrund überwacht.

Die Protokolle der Mac-CLI liegen in ~/Library/Logs/NessieExecutor/<executor-id>.log. Linux-Protokolle erhalten Sie mit journalctl --user -u nessie-executor@<executor-id>.

Aktualisieren Sie mit Ihrem Paketmanager:

brew upgrade nessie-executor
sudo apt-get update && sudo apt-get install --only-upgrade nessie-executor
sudo dnf upgrade nessie-executor

Unter Windows verwenden Sie winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Starten Sie nach dem Update jeden CLI-Dienst mit disable und anschließend enable neu. CLI-Kopplungsschlüssel und lokale Berechtigungen liegen unter ~/.local/state/nessie-executor/. Desktop-Apps speichern ihren Zustand im Anwendungsdatenverzeichnis des Kontos. Beides liegt außerhalb des installierten Pakets und bleibt deshalb bei Updates erhalten.

Zum Entfernen der Software deaktivieren Sie jeden CLI-Dienst oder schalten die Anmeldeoption der App aus und beenden die App; anschließend deinstallieren Sie über denselben Paketmanager. Das Deinstallieren bewahrt den Kopplungszustand. Trennen oder Löschen Sie den Executor in Nessie, um den Zugriff zu widerrufen; das Löschen lokaler Dateien allein widerruft den Serverdatensatz nicht.

Lokale Konfigurationsdetails finden Sie unter lokale Steuerung.