Empieza aquí

Descarga un binario desde GitHub Releases o ejecuta el instalador. Funciona en macOS y Linux, tanto en Intel como en ARM:

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

El instalador verifica la suma de comprobación del archivo y coloca borg en una carpeta de tu PATH, así que puedes ejecutarlo enseguida en el mismo terminal. Elige ~/.local/bin si ya está en tu PATH; si no, /usr/local/bin si tiene permiso de escritura (por ejemplo, como root en un contenedor), y en último caso usa ~/.local/bin y lo añade al archivo de inicio de tu shell. Al terminar, inicia borg; define BORG_NO_RUN=1 para evitarlo, o BORG_INSTALL_DIR para elegir la carpeta. Si ya tienes instalada la misma versión, el instalador no vuelve a descargarla.

El instalador también puede configurar borg como un servicio que arranca con el sistema. El servicio es opcional. Con él, las sesiones que mantienes con borg service keep NAME siguen en marcha sin ningún terminal abierto, y una máquina emparejada llega a este equipo después de un reinicio. En un terminal, el instalador pregunta una vez antes de iniciar borg, y la respuesta predeterminada es n. Define BORG_SERVICE=1 para configurar el servicio sin la pregunta, como en una instalación desatendida, o BORG_SERVICE=0 para omitir la pregunta. La configuración ejecuta borg service install, enable y start, que usan sudo salvo que seas root. Sin terminal y sin la variable, el instalador deja el servicio como está. Puedes configurarlo más tarde dentro de borg, desde F9 → Remoto → Servicio en segundo plano…. Donde falta systemd o launchd, como en la mayoría de los contenedores, el instalador omite este paso y explica el motivo. Si la configuración falla, borg sigue instalado y el instalador muestra los comandos para terminarla a mano. En Linux, la parte del vigilante que se ejecuta como root sigue siendo un paso aparte: instálala con borg service watch install cuando la quieras.

Para compilarlo desde el código fuente necesitas Rust 1.97 o posterior:

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

En Linux, la compilación incluye también los programas eBPF del vigilante de procesos, que necesitan un compilador nightly y bpf-linker. Si faltan, la compilación se detiene y muestra los dos comandos que los instalan. Para compilar sin los programas, define BORG_NO_EBPF=1. El vigilante escucha entonces los eventos de procesos del kernel:

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

La instalación con Homebrew está lista y funcionará en cuanto se publique el tap:

brew install 0xcd21h/tap/borg-commander

Ejecuta borg en la carpeta que quieras explorar. F10 sale, y Ctrl-O vuelve de la consola a los paneles. Para actualizar, ejecuta borg update si descargaste el binario, o usa Homebrew o cargo si lo instalaste así. Borg solo instala una actualización cuando la versión publicada lleva la firma del proyecto. Si la firma falta o es incorrecta, la copia que tienes queda como está. borg --version muestra la versión instalada. Las sesiones abiertas pasan a la nueva versión y conservan su shell (consulta Actualizar con sesiones abiertas).

Una vez al día, Borg busca una nueva versión. Cuando sale una, Borg te la ofrece en cuanto se ven los paneles y llevas 2 segundos sin tocar el teclado ni el ratón. Enter ejecuta borg update en el shell de Borg, o el comando de Homebrew o cargo si Borg se instaló con uno de ellos. S omite esa versión, y Borg te ofrece la siguiente cuando salga. Esc cierra la oferta, y Borg vuelve a preguntar un día después. N desactiva la comprobación diaria poniendo update-check = false en la configuración, y update-check = true la vuelve a activar. Borg guarda la hora de la última comprobación y la versión que omitiste en el archivo update-check, en su carpeta de estado.