Configurar un ejecutor remoto

Instala, empareja y gestiona un ordenador que funciona con los agentes de Nessie.

El ejecutor conecta un ordenador que controlas con Nessie. Instálalo con la cuenta del sistema operativo cuyos archivos y programas debe usar. No necesitas Node.js ni una copia del código fuente.

macOS

La CLI requiere macOS 15 o posterior en Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

Para la app de escritorio completa de Nessie, o para el ejecutor independiente con su ventana de permisos local:

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

Elige la interfaz que quieras usar. Ejecuta un solo supervisor por cada emparejamiento. En la app del ejecutor, Ajustes → Abrir Nessie Executor al iniciar sesión controla el inicio automático.

Debian y Ubuntu

Usa el repositorio APT firmado en Debian 12 o posterior, o en Ubuntu 22.04 o posterior, sobre 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 y AlmaLinux

Usa el repositorio RPM firmado en Fedora, o en Rocky Linux / AlmaLinux 9 o posterior, sobre x86_64:

sudo curl -fsSL https://packages.nessie.works/nessie-executor.repo -o /etc/yum.repos.d/nessie-executor.repo
sudo dnf install nessie-executor

Los servicios de segundo plano de Linux requieren systemd. Los paquetes incluyen el runtime; APT o DNF instalan Git y tmux como dependencias.

Ejecutor para Windows

Instala el ejecutor independiente firmado con WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Abre Nessie Executor desde el menú Inicio o desde la bandeja del sistema. Las nuevas conexiones con equipos se ejecutan con tu cuenta de Windows con la sesión iniciada. El instalador también incluye el supervisor independiente de cuenta de servicio. Los programas de terminal interactivos solo se ejecutan en una conexión de sesión de usuario, donde están disponibles sus credenciales de inicio de sesión.

Emparejar un equipo

Ejecuta la CLI con tu cuenta habitual, sin sudo:

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

Para tu propio servidor de Nessie, sustituye nessie por su URL HTTPS de API. El botón Añadir equipo del ejecutor de escritorio inicia el mismo flujo.

Copia el código de ocho dígitos que aparece en el ordenador.
En Nessie, abre Administración › Ordenadores › Añadir un ordenador. Pega el código, selecciona la organización, el equipo y el ámbito de acceso, y revisa la huella digital.
Confirma en el ordenador la organización y el equipo que se indican.
Comprueba que el ejecutor está en línea, revisa sus capacidades en Nessie y concede acceso a los agentes que quieras.

Los códigos caducan a los diez minutos y sirven una sola vez. Repite login o Añadir equipo para emparejar otro equipo. Cada conexión tiene su propia clave de máquina, sus carpetas, sus reglas de comandos y su servicio de inicio.

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

Todos los comandos están permitidos por defecto, sujetos a comprobaciones estructurales de seguridad; la lista de denegación local prevalece sobre la lista de permitidos. Los permisos de carpetas y comandos se guardan solo en este ordenador y no pueden cambiarse desde Nessie. Nessie controla qué personas y agentes pueden usar la conexión dentro de su equipo. Detén el daemon local antes de cambiar los permisos y vuelve a iniciarlo después.

Los agentes también pueden iniciar Codex, Gemini, Claude, un shell o cualquier otro programa instalado en una terminal interactiva de este ordenador, siempre que lo permitan estas reglas de comandos; no hay nada más configurado. Esos programas deben estar ya instalados y con la sesión iniciada en la misma cuenta, y macOS y Linux necesitan tmux. Un programa de terminal tiene el acceso de la cuenta del sistema operativo, y su carpeta no es un entorno aislado. El command.run con sandbox requiere además el runtime invitado.

Inicio, estado y actualizaciones

El login interactivo activa el inicio automático cuando confirmas el emparejamiento. En macOS, un agente de launchd arranca ese equipo cuando inicias sesión. En Linux, un servicio de usuario de systemd y la opción lingering lo mantienen conectado tras cerrar sesión y tras reiniciar.

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

disable detiene el servicio sin borrar su emparejamiento ni sus permisos. Para una sesión en primer plano, desactiva antes su servicio y luego usa nessie-executor daemon --executor <executor-id>. Los emparejamientos creados con un --state-dir explícito usan supervisión en primer plano.

Los registros de la CLI de Mac están en ~/Library/Logs/NessieExecutor/<executor-id>.log. Los registros de Linux se consultan con journalctl --user -u nessie-executor@<executor-id>.

Actualiza con tu gestor de paquetes:

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

En Windows, usa winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Reinicia cada servicio de la CLI con disable seguido de enable después de actualizar. Las claves de emparejamiento de la CLI y los permisos locales están en ~/.local/state/nessie-executor/. Las apps de escritorio guardan su estado en el directorio de datos de aplicaciones de la cuenta. Ambos están fuera del paquete instalado, así que las actualizaciones los conservan.

Para eliminar el software, desactiva todos los servicios de la CLI, o desactiva en la app el ajuste de inicio de sesión y ciérrala; después desinstala con el mismo gestor de paquetes. Desinstalar conserva el estado de emparejamiento. Desconecta o Elimina el ejecutor en Nessie para revocar el acceso; borrar solo los archivos locales no revoca el registro del servidor.

Para detalles de configuración local, consulta los controles locales.