nessie

Siapkan eksekutor jarak jauh

Pasang, pasangkan, dan kelola komputer yang bekerja bersama agen Nessie.

Eksekutor menghubungkan komputer yang Anda kendalikan ke Nessie. Pasang di bawah akun OS yang berkas dan programnya harus digunakan. Anda tidak perlu Node.js atau salinan kode sumber.

macOS

CLI memerlukan macOS 15 atau yang lebih baru pada Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

Untuk aplikasi desktop Nessie lengkap, atau eksekutor mandiri dengan jendela izin lokalnya:

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

Pilih antarmuka yang ingin Anda gunakan. Jalankan satu supervisor untuk setiap pemasangan. Di aplikasi eksekutor, Settings → Open Nessie Executor when I log in mengatur mulai otomatis.

Debian dan Ubuntu

Gunakan repositori APT yang ditandatangani pada x86_64 Debian 12+ atau 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, dan AlmaLinux

Gunakan repositori RPM yang ditandatangani pada x86_64 Fedora atau 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

Layanan latar belakang Linux memerlukan systemd. Paketnya sudah menyertakan runtime; APT atau DNF ikut menginstal Git dan tmux sebagai dependensi.

Eksekutor Windows

Pasang eksekutor mandiri yang ditandatangani menggunakan WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Buka Nessie Executor dari menu Mulai atau baki sistem. Koneksi tim baru berjalan sebagai akun Windows yang Anda gunakan untuk masuk. Installer juga menyediakan supervisor layanan akun terpisah. Program terminal interaktif hanya berjalan dalam koneksi sesi pengguna, tempat kredensial login-nya tersedia.

Pasangkan tim

Jalankan CLI dengan akun biasa Anda, tanpa sudo:

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

Untuk server Nessie Anda sendiri, ganti nessie dengan URL API HTTPS-nya. Add team pada eksekutor desktop memulai alur yang sama.

  1. Salin kode delapan digit yang ditampilkan di komputer.
  2. Di Nessie, buka Admin › Computers › Add a computer. Tempel kodenya, pilih organisasi, tim, dan cakupan akses, lalu periksa sidik jarinya.
  3. Konfirmasi organisasi dan tim yang diklaim di komputer.
  4. Pastikan eksekutor daring, tinjau kemampuannya di Nessie, dan berikan akses kepada agen yang dimaksud.

Kode kedaluwarsa setelah sepuluh menit dan hanya berlaku sekali. Ulangi login atau Add team untuk memasangkan tim lain. Setiap koneksi memiliki kunci mesin, folder, aturan perintah, dan layanan startup sendiri.

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

Semua perintah diizinkan secara default, tunduk pada pemeriksaan keamanan struktural; daftar blokir lokal mengalahkan daftar izin. Izin folder dan perintah hanya disimpan di komputer ini dan tidak dapat diubah melalui Nessie. Nessie mengontrol orang dan agen mana yang boleh menggunakan koneksi dalam timnya. Hentikan daemon lokal sebelum mengubah izin, lalu jalankan kembali.

Agen juga dapat memulai Codex, Gemini, Claude, shell, atau program terpasang lainnya dalam terminal interaktif di komputer ini, sejauh aturan perintah ini mengizinkan; tidak ada yang lain yang dikonfigurasi. Program tersebut harus sudah terpasang dan sudah masuk di bawah akun yang sama, dan macOS serta Linux memerlukan tmux. Program terminal memiliki akses akun OS, dan foldernya bukan sandbox. command.run dalam sandbox memerlukan runtime tamu secara terpisah.

Mulai otomatis, status, dan pembaruan

login interaktif mengaktifkan mulai otomatis setelah Anda mengonfirmasi pemasangan. Di macOS, agen launchd memulai tim tersebut saat Anda masuk. Di Linux, layanan pengguna systemd dan opsi lingering menjaga koneksi tetap aktif setelah keluar sesi dan setelah reboot.

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

disable menghentikan layanan tanpa menghapus pemasangan atau izinnya. Untuk sesi foreground, nonaktifkan layanannya terlebih dahulu, lalu gunakan nessie-executor daemon --executor <executor-id>. Pemasangan yang dibuat dengan --state-dir eksplisit menggunakan supervisi foreground.

Log CLI macOS berada di ~/Library/Logs/NessieExecutor/<executor-id>.log. Log Linux tersedia dengan journalctl --user -u nessie-executor@<executor-id>.

Tingkatkan dengan package manager Anda:

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

Di Windows, gunakan winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Mulai ulang setiap layanan CLI dengan disable lalu enable setelah meningkatkan. Kunci pemasangan CLI dan izin lokal berada di ~/.local/state/nessie-executor/. Aplikasi desktop menyimpan statenya di direktori data aplikasi akun. Keduanya berada di luar paket yang terpasang, sehingga pembaruan mempertahankannya.

Untuk menghapus perangkat lunak, nonaktifkan setiap layanan CLI atau matikan pengaturan masuk aplikasi lalu keluar dari aplikasinya, kemudian copot pemasangannya melalui package manager yang sama. Mencopot pemasangan mempertahankan state pemasangan. Disconnect atau Delete eksekutor di Nessie untuk mencabut akses; menghapus berkas lokal saja tidak mencabut catatan di server.

Untuk detail konfigurasi lokal, lihat kontrol lokal.