nessie

Nastavení vzdáleného executoru

Nainstalujte, sparujte a spravujte počítač, který spolupracuje s agenty Nessie.

Executor připojuje počítač, který ovládáte, k Nessie. Nainstalujte jej pod účtem operačního systému, jehož soubory a programy má používat. Nepotřebujete Node.js ani zdrojový kód.

macOS

CLI vyžaduje macOS 15 nebo novější na Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

Pro celou desktopovou aplikaci Nessie, nebo pro samostatný executor s jeho místním oknem oprávnění:

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

Zvolte rozhraní, které chcete používat. Pro každé párování spusťte jeden supervizor. V aplikaci executoru řídí automatické spouštění při přihlášení volba Nastavení → Otevřít Nessie Executor při mém přihlášení.

Debian a Ubuntu

Použijte podepsaný repozitář APT na x86_64 Debian 12+ nebo 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 a AlmaLinux

Použijte podepsaný repozitář RPM na x86_64 Fedora nebo 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

Linuxové služby na pozadí vyžadují systemd. Balíčky obsahují běhové prostředí; APT nebo DNF nainstaluje Git a tmux jako závislosti.

Executor pro Windows

Nainstalujte podepsaný samostatný executor pomocí WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Otevřete Nessie Executor z nabídky Start nebo z oblasti oznámení. Nová připojení týmů běží pod vaším přihlášeným účtem Windows. Instalátor dodává také nezávislý supervizor služby s vlastním účtem služby. Interaktivní terminálové programy běží jen v připojení v uživatelské relaci, kde jsou k dispozici jejich přihlašovací údaje.

Spárování týmu

Spusťte CLI pod svým běžným účtem, bez sudo:

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

Pro vlastní server Nessie nahraďte nessie jeho HTTPS adresou API. Tlačítko Přidat tým v desktopovém executoru spustí stejný postup.

  1. Zkopírujte osmimístný kód zobrazený na počítači.
  2. V Nessie otevřete Správa › Počítače › Přidat počítač. Vložte kód, vyberte organizaci, tým a rozsah přístupu a zkontrolujte otisk.
  3. Na počítači potvrďte uvedenou organizaci a tým.
  4. Zkontrolujte, že je executor online, prohlédněte si jeho schopnosti v Nessie a udělte záměrným agentům přístup.

Kódy platí deset minut a fungují jen jednou. Pro spárování dalšího týmu opakujte login nebo Přidat tým. Každé připojení má vlastní strojový klíč, složky, pravidla příkazů a spouštěcí službu.

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

Všechny příkazy jsou ve výchozím nastavení povoleny, s výhradou strukturálních bezpečnostních kontrol; místní seznam zakázaných má přednost před seznamem povolených. Oprávnění ke složkám a příkazům jsou uložena pouze na tomto počítači a nelze je měnit přes Nessie. Nessie řídí, které osoby a agenti smějí připojení v rámci svého týmu používat. Před změnou oprávnění zastavte místní démon a pak jej spusťte znovu.

Agenti mohou také spustit Codex, Gemini, Claude, shell nebo jakýkoli jiný nainstalovaný program v interaktivním terminálu na tomto počítači, pokud to dovolují tato pravidla příkazů; nic dalšího nastaveno není. Takové programy musí být už nainstalované a přihlášené pod stejným účtem a macOS a Linux potřebují tmux. Terminálový program má přístup účtu operačního systému a jeho složka není sandbox. Sandboxovaný command.run navíc vyžaduje běhové prostředí hosta.

Spuštění, stav a aktualizace

Interaktivní login zapne automatické spouštění, jakmile potvrdíte párování. Na macOS agent launchd spustí daný tým při vašem přihlášení. Na Linuxu služba systemd pro uživatele a funkce lingering udrží připojení i přes odhlášení a restart.

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

disable zastaví službu, aniž by smazal její párování a oprávnění. U relace na popředí nejdřív vypněte její službu a pak použijte nessie-executor daemon --executor <executor-id>. Párování vytvořená s explicitním --state-dir běží pod dohledem na popředí.

Logy CLI na macOS jsou v ~/Library/Logs/NessieExecutor/<executor-id>.log. Logy Linuxu jsou dostupné přes journalctl --user -u nessie-executor@<executor-id>.

Aktualizujte pomocí svého správce balíčků:

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

Na Windows použijte winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Po aktualizaci restartujte každou službu CLI příkazem disable a poté enable. Klíče párování CLI a místní oprávnění jsou uloženy v ~/.local/state/nessie-executor/. Desktopové aplikace si drží stav v adresáři dat aplikací daného účtu. Obojí je mimo nainstalovaný balíček, takže aktualizace je zachovají.

Software odstraníte tak, že vypnete každou službu CLI nebo v aplikaci vypnete nastavení přihlášení a aplikaci ukončíte, a pak ji odinstalujete stejným správcem balíčků. Odinstalace zachová stav párování. Chcete-li přístup zrušit, v Nessie Odpojte nebo Smažte executor; samotné smazání místních souborů serverový záznam nezruší.

Podrobnosti o místní konfiguraci najdete v místních ovládacích prvcích.