nessie

Configura un executor remoto

Installa, abbina e gestisci un computer che lavora con gli agenti di Nessie.

L’executor collega a Nessie un computer che controlli tu. Installalo con l’account del sistema operativo i cui file e programmi deve usare. Non serve Node.js né un checkout del codice sorgente.

macOS

La CLI richiede macOS 15 o successivo su Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

Per l’app desktop completa di Nessie, o per l’executor autonomo con la sua finestra dei permessi locali:

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

Scegli l’interfaccia che vuoi usare. Esegui un solo supervisore per ogni associazione. Nell’app dell’executor, Impostazioni → Apri Nessie Executor quando accedo controlla l’avvio automatico.

Debian e Ubuntu

Usa il repository APT firmato su Debian 12+ o Ubuntu 22.04+ 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 e AlmaLinux

Usa il repository RPM firmato su Fedora o Rocky Linux / AlmaLinux 9+ 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

I servizi in background su Linux richiedono systemd. I pacchetti includono il runtime; APT o DNF installano Git e tmux come dipendenze.

Executor per Windows

Installa l’executor autonomo firmato con WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Apri Nessie Executor dal menu Start o dall’area di notifica. Le nuove connessioni ai team girano con il tuo account Windows con cui hai effettuato l’accesso. Il programma di installazione fornisce anche il supervisore indipendente per l’account di servizio. I programmi terminale interattivi girano solo in una connessione di sessione utente, dove sono disponibili le loro credenziali di accesso.

Associa un team

Esegui la CLI con il tuo account normale, senza sudo:

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

Per il tuo server Nessie, sostituisci nessie con il suo URL API HTTPS. Il comando Aggiungi team dell’executor desktop avvia lo stesso flusso.

  1. Copia il codice di otto cifre mostrato sul computer.
  2. In Nessie, apri Admin › Computer › Aggiungi un computer. Incolla il codice, seleziona organizzazione, team e ambito di accesso, e verifica l’impronta.
  3. Conferma sul computer l’organizzazione e il team dichiarati.
  4. Controlla che l’executor sia online, verifica le sue capacità in Nessie e concedi l’accesso agli agenti previsti.

I codici scadono dopo dieci minuti e funzionano una sola volta. Ripeti login o Aggiungi team per associare un altro team. Ogni connessione ha la sua chiave della macchina, le sue cartelle, le sue regole sui comandi e il suo servizio di avvio.

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

Tutti i comandi sono consentiti per impostazione predefinita, fatti salvi i controlli di sicurezza strutturali; la denylist locale prevale sulla allowlist. I permessi su cartelle e comandi sono salvati solo su questo computer e non possono essere modificati tramite Nessie. Nessie controlla quali persone e agenti possono usare la connessione all’interno del suo team. Prima di cambiare i permessi, ferma il daemon locale, poi riavvialo.

Gli agenti possono anche avviare Codex, Gemini, Claude, una shell o qualsiasi altro programma installato in un terminale interattivo su questo computer, nei limiti di queste regole sui comandi; nient’altro è configurato. Questi programmi devono essere già installati e con l’accesso effettuato con lo stesso account, e macOS e Linux richiedono tmux. Un programma terminale ha l’accesso dell’account di sistema, e la sua cartella non è una sandbox. Il comando command.run in sandbox richiede separatamente il runtime guest.

Avvio, stato e aggiornamenti

Il login interattivo attiva l’avvio automatico dopo che confermi l’associazione. Su macOS, un agente launchd avvia quel team quando accedi. Su Linux, un servizio utente systemd e il lingering mantengono la connessione anche dopo il logout e il riavvio.

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

disable ferma il servizio senza cancellare la sua associazione né i suoi permessi. Per una sessione in primo piano, disattiva prima il suo servizio, poi usa nessie-executor daemon --executor <executor-id>. Le associazioni create con un --state-dir esplicito usano la supervisione in primo piano.

I log della CLI su Mac si trovano in ~/Library/Logs/NessieExecutor/<executor-id>.log. I log su Linux sono disponibili con journalctl --user -u nessie-executor@<executor-id>.

Aggiorna con il tuo gestore di pacchetti:

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

Su Windows usa winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Dopo l’aggiornamento riavvia ogni servizio della CLI con disable seguito da enable. Le chiavi di associazione della CLI e i permessi locali si trovano in ~/.local/state/nessie-executor/. Le app desktop conservano il loro stato nella cartella dei dati dell’applicazione dell’account. Entrambi sono fuori dal pacchetto installato, quindi gli aggiornamenti li conservano.

Per rimuovere il software, disattiva ogni servizio della CLI oppure disattiva l’impostazione di accesso dell’app ed esci, poi disinstalla con lo stesso gestore di pacchetti. Disinstallando si conserva lo stato di associazione. Disconnetti o Elimina l’executor in Nessie per revocare l’accesso; eliminare i soli file locali non revoca il record sul server.

Per i dettagli di configurazione locale, vedi controlli locali.