nessie

Sett opp en ekstern executor

Installer, par og administrer en maskin som fungerer med Nessie-agenter.

Executoren kobler en datamaskin du kontrollerer til Nessie. Installer den under operativsystemkontoen hvis filer og programmer den skal bruke. Du trenger ikke Node.js eller en kildekodekopi.

macOS

CLI-en krever macOS 15 eller nyere på Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

For den fulle Nessie-skrivebordsappen, eller den frittstående executoren med vinduet for lokale tillatelser:

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

Velg grensesnittet du vil bruke. Kjør én overvåker for hver paring. I executor-appen styrer Settings → Open Nessie Executor when I log in automatisk oppstart.

Debian og Ubuntu

Bruk det signerte APT-repositoriet på x86_64 Debian 12+ eller 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 og AlmaLinux

Bruk det signerte RPM-repositoriet på x86_64 Fedora eller 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

Bakgrunnstjenester på Linux krever systemd. Pakkene inkluderer kjøretiden. APT eller DNF installerer Git og tmux som avhengigheter.

Windows-executor

Installer den signerte frittstående executoren med WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Åpne Nessie Executor fra Start eller systemstatusfeltet. Nye teamtilkoblinger kjører som din innloggede Windows-konto. Installeringsprogrammet gir også den uavhengige overvåkeren for tjenestekontoen. Interaktive terminalprogrammer kjører bare i en brukerøkttilkobling, der påloggingsopplysningene deres er tilgjengelige.

Par et team

Kjør CLI-en med din vanlige konto, uten sudo:

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

For din egen Nessie-server erstatter du nessie med HTTPS-API-URL-en. Skrivebords-executorens Add team starter samme flyt.

  1. Kopier den åttesifrede koden som vises på datamaskinen.
  2. I Nessie åpner du Admin › Computers › Add a computer. Lim inn koden, velg organisasjon, team og tilgangsomfang, og kontroller fingeravtrykket.
  3. Bekreft organisasjonen og teamet som påstås, på datamaskinen.
  4. Kontroller at executoren er på nett, gjennomgå funksjonene i Nessie, og gi tilgang til de tiltenkte agentene.

Koder utløper etter ti minutter og virker én gang. Gjenta login eller Add team for å pare et annet team. Hver tilkobling har sin egen maskinnøkkel, egne mapper, egne kommandoregler og sin egen oppstartstjeneste.

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 kommandoer er tillatt som standard, under forbehold om strukturelle sikkerhetskontroller. Den lokale blokkeringslisten vinner over tillatelseslisten. Tillatelser for mapper og kommandoer lagres bare på denne datamaskinen, og kan ikke endres gjennom Nessie. Nessie styrer hvilke personer og agenter som kan bruke tilkoblingen innenfor teamet sitt. Stopp den lokale demonen før du endrer tillatelser, og start den deretter på nytt.

Agenter kan også starte Codex, Gemini, Claude, et skall eller et annet installert program i en interaktiv terminal på denne datamaskinen, så langt disse kommandoreglene tillater det. Ingen andre programmer er konfigurert på forhånd. Slike programmer må allerede være installert og innlogget under samme konto, og macOS og Linux trenger tmux. Et terminalprogram har tilgang som operativsystemkontoen, og mappen er ikke en sandkasse. Sandkasset command.run krever i tillegg gjesteruntimen.

Oppstart, status og oppdateringer

Interaktiv login slår på automatisk oppstart etter at du har bekreftet paringen. På macOS starter en launchd-agent det teamet når du logger inn. På Linux holder en systemd-brukertjeneste og lingering den tilkoblet på tvers av utlogging og omstart.

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

disable stopper tjenesten uten å slette paringen eller tillatelsene. For en økt i forgrunnen deaktiverer du tjenesten først, og bruker deretter nessie-executor daemon --executor <executor-id>. Paringer som er opprettet med en eksplisitt --state-dir, bruker overvåking i forgrunnen.

CLI-loggene på Mac ligger i ~/Library/Logs/NessieExecutor/<executor-id>.log. Loggene på Linux vises med journalctl --user -u nessie-executor@<executor-id>.

Oppgrader med pakkebehandleren din:

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

På Windows bruker du winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Start hver CLI-tjeneste på nytt med disable etterfulgt av enable etter oppgraderingen. CLI-paringsnøkler og lokale tillatelser ligger i ~/.local/state/nessie-executor/. Skrivebordsappene beholder tilstanden sin i kontoens programdatamappe. Begge ligger utenfor den installerte pakken, så oppgraderinger beholder dem.

For å fjerne programvaren deaktiverer du alle CLI-tjenestene, eller slår av innloggingsinnstillingen i appen og avslutter den, og avinstallerer deretter med samme pakkebehandler. Avinstallering beholder paringstilstanden. Disconnect eller Delete executoren i Nessie for å tilbakekalle tilgangen. Å slette lokale filer alene tilbakekaller ikke serverposten.

For detaljer om lokal konfigurasjon, se lokale kontroller.