Começar aqui

Transfira um binário a partir das GitHub Releases ou execute o instalador. Funciona em macOS e Linux, tanto em Intel como em ARM:

curl -fsSL https://raw.githubusercontent.com/0xcd21h/borg-commander/main/scripts/install.sh | sh

O instalador verifica a soma de controlo do arquivo e coloca borg numa pasta do seu PATH, para que o possa executar de imediato no mesmo terminal. Escolhe ~/.local/bin se essa pasta já estiver no PATH; caso contrário, /usr/local/bin se tiver permissão de escrita (por exemplo, como root num contentor); se nenhuma servir, usa ~/.local/bin e acrescenta-a ao ficheiro de arranque da sua shell. No fim, inicia o borg; defina BORG_NO_RUN=1 para o impedir, ou BORG_INSTALL_DIR para escolher a pasta. Se a mesma versão já estiver instalada, voltar a executar o instalador dispensa a transferência.

O instalador também pode configurar o borg como um serviço que arranca com o sistema. O serviço é opcional. Com ele, as sessões que mantém com borg service keep NAME continuam em execução sem terminal aberto, e uma máquina emparelhada chega a este computador depois de um reinício. Num terminal, o instalador pergunta uma vez antes de iniciar o borg, e a resposta predefinida é n. Defina BORG_SERVICE=1 para configurar o serviço sem a pergunta, como numa instalação autónoma, ou BORG_SERVICE=0 para dispensar a pergunta. A configuração executa borg service install, enable e start, que usam sudo, a menos que seja root. Sem terminal e sem a variável, o instalador deixa o serviço como está. Pode configurá-lo mais tarde dentro do borg, em F9 → Remoto → Serviço em segundo plano…. Onde não há systemd nem launchd, como na maioria dos contentores, o instalador salta este passo e diz porquê. Se a configuração falhar, o borg continua instalado e o instalador mostra os comandos para a concluir à mão. Em Linux, a parte do observador que corre como root continua a ser um passo à parte: instale-a com borg service watch install quando a quiser.

Para compilar a partir do código-fonte, precisa do Rust 1.97 ou mais recente:

cargo install --locked --git https://github.com/0xcd21h/borg-commander borg-app

No Linux, a compilação inclui também os programas eBPF do observador de processos, que precisam de um compilador nightly e do bpf-linker. Quando faltam, a compilação para e mostra os dois comandos que os instalam. Para compilar sem os programas, defina BORG_NO_EBPF=1. O observador ouve então os eventos de processo do kernel:

BORG_NO_EBPF=1 cargo install --locked --git https://github.com/0xcd21h/borg-commander borg-app

O suporte para Homebrew já está preparado e passará a funcionar quando o tap for publicado:

brew install 0xcd21h/tap/borg-commander

Execute borg na pasta que pretende explorar. F10 sai e Ctrl-O passa da consola para os painéis. Para atualizar, execute borg update numa cópia transferida, ou use o Homebrew ou o cargo se tiver instalado dessa forma. O Borg só instala uma atualização quando a versão publicada traz a assinatura do projeto. Se a assinatura faltar ou estiver errada, a cópia instalada fica como está. borg --version mostra a versão instalada. As sessões abertas passam para a nova versão e mantêm as suas shells (consulte Atualizar com sessões abertas).

Uma vez por dia, o Borg procura uma nova versão. Quando sai uma, o Borg propõe-na assim que os painéis estiverem visíveis e não tiver tocado no teclado nem no rato durante 2 segundos. Enter executa borg update na shell do Borg, ou o comando do Homebrew ou do cargo quando foi um deles a instalar o Borg. S salta essa versão, e o Borg propõe a seguinte quando sair. Esc fecha a proposta, e o Borg volta a perguntar um dia depois. N desliga a verificação diária ao definir update-check = false na configuração, e update-check = true volta a ligá-la. O Borg guarda a hora da última verificação e a versão que saltou no ficheiro update-check, na sua pasta de estado.