nessie

Configura un executor remot

Instal·la, empareja i gestiona un ordinador que funciona amb els agents de Nessie.

L’executor connecta un ordinador que controles amb Nessie. Instal·la’l amb el compte del sistema operatiu que tingui els fitxers i els programes que l’executor ha d’utilitzar. No necessites Node.js ni una còpia del codi font.

macOS

La CLI requereix macOS 15 o posterior en Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

Per a l’aplicació d’escriptori completa de Nessie, o per a l’executor independent amb la seva finestra de permisos locals:

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

Tria la interfície que vols utilitzar. Executa un sol supervisor per a cada emparellament. A l’aplicació de l’executor, Configuració → Obre Nessie Executor en iniciar sessió controla l’inici automàtic.

Debian i Ubuntu

Utilitza el repositori APT signat en Debian 12+ o Ubuntu 22.04+, en x86_64:

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

Utilitza el repositori RPM signat en Fedora, o en Rocky Linux o AlmaLinux 9+, en x86_64:

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

Els serveis de segon pla de Linux requereixen systemd. Els paquets ja inclouen l’entorn d’execució; APT o DNF instal·len Git i tmux com a dependències.

Executor per a Windows

Instal·la l’executor independent signat amb WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Obre Nessie Executor des de l’inici o des de la safata. Les noves connexions d’equip s’executen com al teu compte de Windows, amb la sessió iniciada. L’instal·lador també proporciona el supervisor de servei independent, amb compte de servei. Els programes de terminal interactius només s’executen en una connexió de sessió d’usuari, on les seves credencials d’inici de sessió són disponibles.

Empareja un equip

Executa la CLI amb el teu compte habitual, sense sudo:

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

Per al teu propi servidor de Nessie, substitueix nessie per la seva adreça d’API HTTPS. L’opció Afegeix un equip de l’executor d’escriptori inicia el mateix procés.

  1. Copia el codi de vuit dígits que es mostra a l’ordinador.
  2. A Nessie, obre Admin › Ordinadors › Afegeix un ordinador. Enganxa el codi, selecciona l’organització, l’equip i l’abast d’accés, i revisa l’empremta digital.
  3. Confirma a l’ordinador l’organització i l’equip que s’hi indiquen.
  4. Comprova que l’executor està en línia, revisa les seves capacitats a Nessie i concedeix l’accés als agents que vols.

Els codis caduquen als deu minuts i només funcionen una vegada. Repeteix login o Afegeix un equip per emparellar un altre equip. Cada connexió té la seva pròpia clau de màquina, les seves carpetes, les seves regles d’ordres i el seu servei d’inici.

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

De manera predeterminada, totes les ordres estan permeses, sota les comprovacions de seguretat estructurals; la llista de denegació local preval sobre la llista d’autorització. Els permisos de carpetes i d’ordres només es desen en aquest ordinador i no es poden canviar des de Nessie. Nessie controla quines persones i quins agents poden utilitzar la connexió dins del seu equip. Atura el dimoni local abans de canviar els permisos i després torna’l a iniciar.

Els agents també poden iniciar Codex, Gemini, Claude, un intèrpret d’ordres o qualsevol altre programa instal·lat en un terminal interactiu d’aquest ordinador, sempre que les regles d’ordres ho permetin; no se n’hi configura cap altre. Aquests programes ja han d’estar instal·lats i amb la sessió iniciada amb el mateix compte, i macOS i Linux necessiten tmux. Un programa de terminal té l’accés del compte del sistema operatiu, i la carpeta on s’executa no és un entorn aïllat. L’command.run aïllat (sandbox) requereix a més el entorn d’execució de la convidada.

Inici, estat i actualitzacions

L’ordre interactiva login activa l’inici automàtic un cop confirmat l’emparellament. A macOS, un agent de launchd inicia aquest equip quan inicies sessió. A Linux, un servei d’usuari de systemd i lingering el mantenen connectat després de tancar la sessió i en reiniciar l’ordinador.

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

disable atura el servei sense eliminar-ne l’emparellament ni els permisos. Per a una sessió en primer pla, desactiva primer el seu servei i després utilitza nessie-executor daemon --executor <executor-id>. Els emparellaments creats amb un --state-dir explícit utilitzen la supervisió en primer pla.

Els registres de la CLI de Mac són a ~/Library/Logs/NessieExecutor/<executor-id>.log. Els registres de Linux es poden consultar amb journalctl --user -u nessie-executor@<executor-id>.

Actualitza amb el teu gestor de paquets:

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

A Windows, utilitza winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Després d’actualitzar, reinicia cada servei de la CLI amb disable seguit de enable. Les claus d’emparellament de la CLI i els permisos locals són a ~/.local/state/nessie-executor/. Les aplicacions d’escriptori guarden el seu estat al directori de dades d’aplicació del compte. Tots dos són fora del paquet instal·lat, de manera que les actualitzacions els conserven.

Per eliminar el programari, desactiva tots els serveis de la CLI o desactiva l’opció d’inici de sessió de l’aplicació i tanca-la, i després desinstal·la-la amb el mateix gestor de paquets. Desinstal·lar conserva l’estat d’emparellament. Desconnecta o Elimina l’executor a Nessie per revocar l’accés; eliminar només els fitxers locals no elimina el registre del servidor.

Per als detalls de configuració local, consulta els controls locals.