nessie

Een externe executor instellen

Installeer, koppel en beheer een computer die werkt met Nessie-agents.

De executor koppelt een computer die jij beheert aan Nessie. Installeer hem onder het besturingssysteemaccount waarvan hij de bestanden en programma’s moet gebruiken. Je hebt geen Node.js of broncodecheckout nodig.

macOS

De CLI vereist macOS 15 of later op Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

Voor de volledige Nessie-desktopapp, of de losse executor met zijn lokale rechtenvenster:

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

Kies de interface die je wilt gebruiken. Draai één supervisor per koppeling. In de executor-app bepaalt Instellingen → Nessie Executor openen wanneer ik inlog of hij automatisch start.

Debian en Ubuntu

Gebruik de ondertekende APT-repository op x86_64 Debian 12+ of 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 en AlmaLinux

Gebruik de ondertekende RPM-repository op x86_64 Fedora of 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-achtergrondservices vereisen systemd. De pakketten bevatten de runtime; APT of DNF installeert Git en tmux als afhankelijkheden.

Windows-executor

Installeer de ondertekende losse executor met WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Open Nessie Executor via het Startmenu of het systeemvak. Nieuwe teamverbindingen draaien als jouw ingelogde Windows-account. Het installatieprogramma levert ook de onafhankelijke service-accountsupervisor. Interactieve terminalprogramma’s draaien alleen in een verbinding binnen de gebruikerssessie, waar hun inloggegevens beschikbaar zijn.

Een team koppelen

Voer de CLI uit met je gewone account, zonder sudo:

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

Voor je eigen Nessie-server vervang je nessie door de HTTPS-API-URL. Met Team toevoegen in de desktop-executor start je dezelfde stroom.

  1. Kopieer de achtcijferige code die op de computer wordt getoond.
  2. Open in Nessie Admin › Computers › Een computer toevoegen. Plak de code, selecteer de organisatie, het team en het toegangsbereik, en controleer de vingerafdruk.
  3. Bevestig de opgegeven organisatie en het team op de computer.
  4. Controleer of de executor online is, bekijk zijn mogelijkheden in Nessie en geef de bedoelde agents toegang.

Codes verlopen na tien minuten en werken één keer. Herhaal login of Team toevoegen om nog een team te koppelen. Elke verbinding heeft zijn eigen machinesleutel, eigen mappen, eigen regels voor opdrachten en eigen opstartservice.

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 opdrachten zijn standaard toegestaan, onder voorbehoud van structurele veiligheidscontroles; de lokale blokkeerlijst wint van de toegestane lijst. Map- en opdrachtrechten worden alleen op deze computer opgeslagen en kunnen niet via Nessie worden gewijzigd. Nessie bepaalt welke personen en agents de verbinding binnen hun team mogen gebruiken. Stop de lokale daemon voordat je rechten wijzigt, en start hem daarna weer.

Agents kunnen ook Codex, Gemini, Claude, een shell of elk ander geïnstalleerd programma starten in een interactieve terminal op deze computer, voor zover deze regels voor opdrachten dat toestaan; er is verder niets ingesteld. Zulke programma’s moeten al geïnstalleerd zijn en onder hetzelfde account zijn ingelogd, en macOS en Linux hebben tmux nodig. Een terminalprogramma heeft de toegang van het besturingssysteemaccount, en de map ervan is geen sandbox. In een sandbox draaiende command.run vereist apart de gastruntime.

Opstarten, status en updates

Interactieve login schakelt automatisch opstarten in zodra je de koppeling hebt bevestigd. Op macOS start een launchd-agent de verbinding met dat team wanneer je inlogt. Op Linux houden een systemd-gebruikersservice en lingering de verbinding in stand na uitloggen en herstarten.

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

disable stopt de service zonder de koppeling of de rechten te verwijderen. Voor een sessie op de voorgrond schakel je eerst de service uit en gebruik je daarna nessie-executor daemon --executor <executor-id>. Koppelingen die met een expliciete --state-dir zijn aangemaakt, gebruiken supervisie op de voorgrond.

De logs van de Mac-CLI staan in ~/Library/Logs/NessieExecutor/<executor-id>.log. Linux-logs zijn beschikbaar met journalctl --user -u nessie-executor@<executor-id>.

Werk bij met je pakketbeheerder:

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

Gebruik op Windows winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Herstart elke CLI-service na het bijwerken met disable gevolgd door enable. CLI-koppelsleutels en lokale rechten staan in ~/.local/state/nessie-executor/. Desktopapps bewaren hun status in de map voor applicatiedata van het account. Beide staan buiten het geïnstalleerde pakket, dus een update behoudt ze.

Om de software te verwijderen, schakel je elke CLI-service uit of zet je de inlogoptie van de app uit en sluit je de app af, en verwijder je hem daarna via dezelfde pakketbeheerder. Verwijderen behoudt de koppelingsstatus. Ontkoppel of Verwijder de executor in Nessie om de toegang in te trekken; alleen lokale bestanden verwijderen trekt het serverrecord niet in.

Zie lokale instellingen voor details over de lokale configuratie.