nessie

Konfigurera en fjärrexecutor

Installera, para ihop och hantera en dator som fungerar med Nessie-agenter.

Executorn ansluter en dator som du kontrollerar till Nessie. Installera den under det OS-konto vars filer och program den ska använda. Du behöver varken Node.js eller en källkodskopia.

macOS

CLI:n kräver macOS 15 eller senare på Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

För hela Nessie-skrivbordsappen, eller den fristående executorn med sitt lokala behörighetsfönster:

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

Välj det gränssnitt du vill använda. Kör en supervisor för varje parkoppling. I executor-appen styr Inställningar → Öppna Nessie Executor när jag loggar in automatisk start.

Debian och Ubuntu

Använd det signerade APT-förrådet 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 och AlmaLinux

Använd det signerade RPM-förrådet 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

Bakgrundstjänster i Linux kräver systemd. Paketen innehåller körmiljön; APT eller DNF installerar Git och tmux som beroenden.

Windows-executor

Installera den signerade fristående executorn med WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Öppna Nessie Executor från Start eller meddelandeområdet. Nya teamanslutningar körs som ditt inloggade Windows-konto. Installationsprogrammet levererar också den självständiga supervisorn för tjänstekontot. Interaktiva terminalprogram körs bara i en anslutning i användarsessionen, där deras inloggningsuppgifter finns tillgängliga.

Parkoppla ett team

Kör CLI:n med ditt vanliga konto, utan sudo:

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

För din egen Nessie-server ersätter du nessie med dess HTTPS-API-adress. Skrivbordsexecutorns Lägg till team startar samma flöde.

  1. Kopiera den åttasiffriga kod som visas på datorn.
  2. I Nessie öppnar du Admin › Datorer › Lägg till en dator. Klistra in koden, välj organisation, team och åtkomstomfång, och granska fingeravtrycket.
  3. Bekräfta den påstådda organisationen och teamet på datorn.
  4. Kontrollera att executorn är online, granska dess förmågor i Nessie och ge de avsedda agenterna åtkomst.

Koder går ut efter tio minuter och fungerar en gång. Upprepa login eller Lägg till team för att parkoppla ett annat team. Varje anslutning har sin egen maskinnyckel, egna mappar, egna kommandoregler och sin egen startuptjänst.

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

Alla kommandon är tillåtna som standard, med förbehåll för strukturella säkerhetskontroller; den lokala svartlistan går före vitlistan. Mapp- och kommandobehörigheter lagras bara på den här datorn och kan inte ändras via Nessie. Nessie styr vilka personer och agenter som får använda anslutningen inom sitt team. Stoppa den lokala demonen innan du ändrar behörigheter och starta den sedan igen.

Agenter kan också starta Codex, Gemini, Claude, ett skal eller något annat installerat program i en interaktiv terminal på den här datorn, i den mån dessa kommandoregler tillåter; inget annat är konfigurerat. Sådana program måste redan vara installerade och inloggade under samma konto, och macOS och Linux behöver tmux. Ett terminalprogram har OS-kontots åtkomst, och dess mapp är ingen sandbox. Sandboxad command.run kräver separat gästkörmiljön.

Start, status och uppdateringar

Interaktiv login aktiverar automatisk start när du har bekräftat parkopplingen. På macOS startar en launchd-agent det teamet när du loggar in. På Linux håller en systemd-användartjänst och lingering det anslutet över utloggning och omstart.

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

disable stoppar tjänsten utan att ta bort dess parkoppling eller behörigheter. För en förgrundssession inaktiverar du först dess tjänst och kör sedan nessie-executor daemon --executor <executor-id>. Parkopplingar som skapats med en explicit --state-dir använder förgrundsövervakning.

Loggarna för CLI:n på Mac finns i ~/Library/Logs/NessieExecutor/<executor-id>.log. Loggar för Linux når du med journalctl --user -u nessie-executor@<executor-id>.

Uppgradera med din pakethanterare:

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

På Windows använder du winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Starta om varje CLI-tjänst med disable följt av enable efter uppgraderingen. CLI-parkopplingsnycklar och lokala behörigheter ligger i ~/.local/state/nessie-executor/. Skrivbordsappar sparar sitt tillstånd i kontots programdatakatalog. Båda ligger utanför det installerade paketet, så uppgraderingar bevarar dem.

För att ta bort programvaran inaktiverar du varje CLI-tjänst eller stänger av appens inloggningsinställning och avslutar den, och avinstallerar sedan via samma pakethanterare. Avinstallation bevarar parkopplingens tillstånd. Koppla från eller Ta bort executorn i Nessie för att återkalla åtkomsten; att bara ta bort lokala filer återkallar inte serverposten.

För lokala konfigurationsdetaljer, se lokala inställningar.