nessie

Configurar um executor remoto

Instalar, emparelhar e gerir um computador que trabalha com os agentes do Nessie.

O executor liga ao Nessie um computador que controla. Instale-o com a conta do sistema operativo cujos ficheiros e programas deve usar. Não precisa de Node.js nem de uma cópia do código-fonte.

macOS

A CLI requer macOS 15 ou posterior em Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

Para a aplicação completa do Nessie para computador, ou para o executor autónomo com a respetiva janela de permissões locais:

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

Escolha a interface que pretende usar. Execute um supervisor por cada emparelhamento. Na aplicação do executor, Definições → Abrir o Nessie Executor ao iniciar sessão controla o arranque automático.

Debian e Ubuntu

Use o repositório APT assinado em Debian 12+ ou Ubuntu 22.04+, em 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 e AlmaLinux

Use o repositório RPM assinado em Fedora ou Rocky Linux / AlmaLinux 9+, em 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

Os serviços em segundo plano do Linux requerem systemd. Os pacotes incluem o ambiente de execução; o APT ou o DNF instala o Git e o tmux como dependências.

Executor para Windows

Instale o executor autónomo assinado com o WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Abra o Nessie Executor a partir do Menu Iniciar ou da área de notificação. As novas ligações de equipa são executadas com a conta Windows em que a sessão está iniciada. O instalador fornece também o supervisor independente da conta de serviço. Os programas de terminal interativos só são executados numa ligação de sessão de utilizador, onde as respetivas credenciais de início de sessão estão disponíveis.

Emparelhar uma equipa

Execute a CLI com a conta normal, sem sudo:

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

Para um servidor Nessie próprio, substitua nessie pelo URL HTTPS da API. O Adicionar equipa do executor para computador inicia o mesmo processo.

  1. Copie o código de oito dígitos apresentado no computador.
  2. No Nessie, abra Administração › Computadores › Adicionar um computador. Cole o código, selecione a organização, a equipa e o âmbito de acesso, e verifique a impressão digital.
  3. Confirme no computador a organização e a equipa indicadas.
  4. Verifique se o executor está online, reveja as respetivas capacidades no Nessie e conceda acesso aos agentes pretendidos.

Os códigos expiram ao fim de dez minutos e só funcionam uma vez. Repita login ou Adicionar equipa para emparelhar outra equipa. Cada ligação tem a sua própria chave de máquina, as suas pastas, as suas regras de comandos e o seu serviço de arranque.

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 os comandos são permitidos por predefinição, sujeitos a verificações estruturais de segurança; a lista de bloqueio local prevalece sobre a lista de permissões. As permissões de pastas e comandos ficam guardadas apenas neste computador e não podem ser alteradas através do Nessie. O Nessie controla quais as pessoas e os agentes que podem usar a ligação dentro da respetiva equipa. Pare o daemon local antes de alterar as permissões e depois inicie-o novamente.

Os agentes podem também iniciar o Codex, o Gemini, o Claude, uma shell ou qualquer outro programa instalado num terminal interativo deste computador, desde que as regras de comandos o permitam; nada mais está configurado. Estes programas têm de estar já instalados e com sessão iniciada na mesma conta, e o macOS e o Linux precisam do tmux. Um programa de terminal tem o acesso da conta do sistema operativo, e a sua pasta não é um sandbox. O command.run em sandbox requer à parte o ambiente de execução convidado.

Arranque, estado e atualizações

Um login interativo ativa o arranque automático depois de confirmar o emparelhamento. No macOS, um agente launchd inicia essa equipa quando inicia sessão. No Linux, um serviço de utilizador do systemd e a opção lingering mantêm a ligação ativa após o fim de sessão e o reinício.

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

disable para o serviço sem apagar o emparelhamento nem as permissões. Para uma sessão em primeiro plano, desative primeiro o respetivo serviço e depois use nessie-executor daemon --executor <executor-id>. Os emparelhamentos criados com --state-dir explícito usam supervisão em primeiro plano.

Os registos da CLI no Mac estão em ~/Library/Logs/NessieExecutor/<executor-id>.log. Os registos do Linux estão disponíveis com journalctl --user -u nessie-executor@<executor-id>.

Atualize com o gestor de pacotes:

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

No Windows, use winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Reinicie cada serviço da CLI com disable seguido de enable depois de atualizar. As chaves de emparelhamento da CLI e as permissões locais estão em ~/.local/state/nessie-executor/. As aplicações de ambiente de trabalho guardam o estado no diretório de dados de aplicações da conta do utilizador. Ambos ficam fora do pacote instalado, pelo que as atualizações os preservam.

Para remover o software, desative todos os serviços da CLI ou desligue a definição de início de sessão da aplicação e saia dela, e depois desinstale com o mesmo gestor de pacotes. Desinstalar preserva o estado do emparelhamento. Desligue ou Elimine o executor no Nessie para revogar o acesso; apagar apenas os ficheiros locais não revoga o registo no servidor.

Para detalhes da configuração local, veja os controlos locais.