nessie

Configurer un exécuteur à distance

Installez, appairez et gérez un ordinateur qui fonctionne avec les agents Nessie.

L’exécuteur relie à Nessie un ordinateur que vous contrôlez. Installez-le sous le compte du système d’exploitation dont il doit utiliser les fichiers et les programmes. Vous n’avez besoin ni de Node.js ni d’un clone du dépôt source.

macOS

La CLI nécessite macOS 15 ou une version ultérieure sur Apple Silicon :

brew install unlikeotherai/tap/nessie-executor

Pour l’application de bureau Nessie complète, ou l’exécuteur autonome avec sa fenêtre locale d’autorisations :

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

Choisissez l’interface que vous voulez utiliser. Lancez un superviseur par appairage. Dans l’application de l’exécuteur, Réglages → Ouvrir Nessie Executor lors de ma connexion contrôle le démarrage automatique.

Debian et Ubuntu

Utilisez le dépôt APT signé sur Debian 12+ ou 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 et AlmaLinux

Utilisez le dépôt RPM signé sur Fedora (x86_64) ou 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

Les services Linux en arrière-plan nécessitent systemd. Les paquets incluent l’environnement d’exécution ; APT ou DNF installe Git et tmux comme dépendances.

Exécuteur Windows

Installez l’exécuteur autonome signé avec WinGet :

winget install --exact --id UnlikeOtherAI.NessieExecutor

Ouvrez Nessie Executor depuis le menu Démarrer ou la zone de notification. Les nouvelles connexions d’équipe s’exécutent sous votre compte Windows connecté. L’installateur fournit aussi le superviseur indépendant du compte de service. Les programmes de terminal interactifs ne s’exécutent que dans une connexion de session utilisateur, où leurs identifiants de connexion sont disponibles.

Appairer une équipe

Lancez la CLI avec votre compte habituel, sans sudo :

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

Pour votre propre serveur Nessie, remplacez nessie par son URL d’API HTTPS. Le bouton Ajouter une équipe de l’exécuteur de bureau lance le même parcours.

  1. Copiez le code à huit chiffres affiché sur l’ordinateur.
  2. Dans Nessie, ouvrez Admin › Ordinateurs › Ajouter un ordinateur. Collez le code, sélectionnez l’organisation, l’équipe et la portée d’accès, puis vérifiez l’empreinte.
  3. Sur l’ordinateur, confirmez l’organisation et l’équipe annoncées.
  4. Vérifiez que l’exécuteur est en ligne, examinez ses capacités dans Nessie et accordez l’accès aux agents prévus.

Les codes expirent au bout de dix minutes et ne fonctionnent qu’une fois. Répétez login ou Ajouter une équipe pour appairer une autre équipe. Chaque connexion a sa propre clé machine, ses propres dossiers, ses propres règles de commandes et son propre service de démarrage.

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

Toutes les commandes sont autorisées par défaut, sous réserve des contrôles de sécurité structurels ; la liste de refus locale l’emporte sur la liste d’autorisation. Les permissions de dossiers et de commandes ne sont stockées que sur cet ordinateur et ne peuvent pas être modifiées depuis Nessie. Nessie contrôle les personnes et les agents qui peuvent utiliser la connexion au sein de leur équipe. Arrêtez le démon local avant de modifier les permissions, puis relancez-le.

Les agents peuvent aussi lancer Codex, Gemini, Claude, un shell ou tout autre programme installé dans un terminal interactif sur cet ordinateur, dans la limite de ces règles de commandes ; rien d’autre n’est configuré. Ces programmes doivent déjà être installés et connectés sous le même compte, et macOS comme Linux ont besoin de tmux. Un programme de terminal dispose des accès du compte du système d’exploitation, et son dossier n’est pas un bac à sable. Le command.run isolé exige séparément le environnement d’exécution invité.

Démarrage, état et mises à jour

Le login interactif active le démarrage automatique une fois que vous avez confirmé l’appairage. Sous macOS, un agent launchd démarre cette équipe à votre connexion. Sous Linux, un service utilisateur systemd et le lingering la maintiennent connectée après la déconnexion et le redémarrage.

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

disable arrête le service sans supprimer son appairage ni ses permissions. Pour une session au premier plan, désactivez d’abord son service, puis utilisez nessie-executor daemon --executor <executor-id>. Les appairages créés avec un --state-dir explicite utilisent une supervision au premier plan.

Les journaux de la CLI sur Mac se trouvent dans ~/Library/Logs/NessieExecutor/<executor-id>.log. Les journaux Linux sont disponibles avec journalctl --user -u nessie-executor@<executor-id>.

Mettez à jour avec votre gestionnaire de paquets :

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

Sous Windows, utilisez winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Après la mise à jour, redémarrez chaque service de la CLI avec disable puis enable. Les clés d’appairage de la CLI et les permissions locales se trouvent dans ~/.local/state/nessie-executor/. Les applications de bureau conservent leur état dans le répertoire de données d’application du compte. Ces emplacements sont hors du paquet installé, si bien que les mises à jour les conservent.

Pour supprimer le logiciel, désactivez chaque service de la CLI ou désactivez le réglage de connexion de l’application puis quittez-la, puis désinstallez avec le même gestionnaire de paquets. La désinstallation conserve l’état d’appairage. Déconnectez ou supprimez l’exécuteur dans Nessie pour révoquer l’accès ; la simple suppression des fichiers locaux ne révoque pas l’enregistrement sur le serveur.

Pour les détails de configuration locale, voir contrôles locaux.