nessie

Configurați un executor la distanță

Instalați, asociați și gestionați un calculator care lucrează cu agenții Nessie.

Executorul conectează la Nessie un calculator pe care îl controlați. Instalați-l sub contul de sistem de operare ale cărui fișiere și programe trebuie să le folosească. Nu aveți nevoie de Node.js sau de un checkout al codului sursă.

macOS

CLI-ul necesită macOS 15 sau o versiune mai nouă, pe Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

Pentru aplicația desktop completă Nessie sau pentru executorul independent, cu fereastra lui locală de permisiuni:

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

Alegeți interfața pe care vreți să o folosiți. Rulați un singur supervizor pentru fiecare asociere. În aplicația executor, Setări → Deschide Nessie Executor la autentificare controlează pornirea automată.

Debian și Ubuntu

Folosiți depozitul APT semnat pe x86_64 Debian 12+ sau 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 și AlmaLinux

Folosiți depozitul RPM semnat pe Fedora x86_64 sau 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

Serviciile de fundal Linux necesită systemd. Pachetele includ runtime-ul; APT sau DNF instalează Git și tmux ca dependențe.

Executorul pentru Windows

Instalați executorul independent semnat folosind WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Deschideți Nessie Executor din meniul Start sau din zona de notificări. Conexiunile noi ale echipelor rulează sub contul dvs. Windows, cu care sunteți autentificat. Programul de instalare oferă și supervizorul independent pentru contul de serviciu. Programele de terminal interactive rulează doar într-o conexiune de sesiune de utilizator, unde sunt disponibile acreditările lor de autentificare.

Asociați o echipă

Rulați CLI-ul cu contul dvs. obișnuit, fără sudo:

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

Pentru propriul server Nessie, înlocuiți nessie cu adresa HTTPS a API-ului său. Butonul Adaugă echipă din executorul desktop pornește același flux.

  1. Copiați codul din opt cifre afișat pe calculator.
  2. În Nessie, deschideți Admin › Calculatoare › Adaugă un calculator. Lipiți codul, selectați organizația, echipa și sfera de acces și verificați amprenta.
  3. Confirmați pe calculator organizația și echipa declarate.
  4. Verificați că executorul este online, examinați capacitățile lui în Nessie și acordați agenților doriți accesul.

Codurile expiră după zece minute și funcționează o singură dată. Repetați login sau Adaugă echipă ca să asociați o altă echipă. Fiecare conexiune are propria cheie de mașină, propriile foldere, propriile reguli de comenzi și propriul serviciu de pornire.

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 *"

Toate comenzile sunt permise implicit, sub rezerva verificărilor structurale de siguranță; lista locală de interdicții are prioritate față de lista de permise. Permisiunile pentru foldere și comenzi sunt stocate doar pe acest calculator și nu pot fi modificate prin Nessie. Nessie controlează ce persoane și ce agenți pot folosi conexiunea în cadrul echipei sale. Opriți demonul local înainte să schimbați permisiunile, apoi porniți-l din nou.

Agenții pot porni și Codex, Gemini, Claude, un shell sau orice alt program instalat, într-un terminal interactiv de pe acest calculator, în măsura în care aceste reguli de comenzi o permit; nimic altceva nu este configurat. Asemenea programe trebuie să fie deja instalate și autentificate sub același cont, iar macOS și Linux au nevoie de tmux. Un program de terminal are accesul contului de sistem de operare, iar folderul lui nu este o sandbox. command.run în sandbox necesită separat runtime-ul de oaspete.

Pornire, stare și actualizări

Autentificarea interactivă login activează pornirea automată după ce confirmați asocierea. Pe macOS, un agent launchd pornește echipa respectivă când vă conectați. Pe Linux, un serviciu systemd de utilizator și lingering o mențin conectată după deconectare și după repornire.

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

disable oprește serviciul fără să șteargă asocierea sau permisiunile. Pentru o sesiune în prim-plan, dezactivați mai întâi serviciul ei, apoi folosiți nessie-executor daemon --executor <executor-id>. Asocierile create cu un --state-dir explicit folosesc supravegherea în prim-plan.

Jurnalele CLI de pe Mac se află în ~/Library/Logs/NessieExecutor/<executor-id>.log. Jurnalele Linux sunt disponibile cu journalctl --user -u nessie-executor@<executor-id>.

Actualizați cu managerul de pachete:

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

Pe Windows, folosiți winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Reporniți fiecare serviciu CLI cu disable, urmat de enable, după actualizare. Cheile de asociere CLI și permisiunile locale se află în ~/.local/state/nessie-executor/. Aplicațiile desktop își păstrează starea în directorul de date al aplicațiilor contului. Ambele se află în afara pachetului instalat, deci actualizările le păstrează.

Ca să eliminați programul, dezactivați fiecare serviciu CLI sau opriți setarea de autentificare a aplicației și închideți-o, apoi dezinstalați prin același manager de pachete. Dezinstalarea păstrează starea asocierii. Deconectați sau Ștergeți executorul în Nessie ca să revocați accesul; ștergerea doar a fișierelor locale nu revocă înregistrarea de pe server.

Pentru detalii despre configurarea locală, consultați comenzile locale.