PlanBefore
InicioDescargaInstalaciónVersionesGitHub

Instala PlanBefore

De la descarga a un Node funcionando en siete pasos. No necesitas Go ni el código fuente, solo git y rg (ripgrep).

Requisitos

  • macOS 12 o posterior (Apple Silicon o Intel), una distribución Linux de 64 bits (x86_64 o ARM64) o Windows 10/11 (x64 o ARM64).
  • git y rg (ripgrep) en tu PATH. PlanBefore los usa para leer el historial de Git y buscar código.
  • Una cuenta de PlanBefore con una passkey. Actualmente las cuentas son solo por invitación.
# macOS (Homebrew)
brew install git ripgrep
# Debian / Ubuntu
sudo apt install git ripgrep
# Fedora
sudo dnf install git ripgrep
# Windows (PowerShell)
winget install --id Git.Git -e
winget install --id BurntSushi.ripgrep.MSVC -e

  1. Instalar

    Ejecuta el instalador de tu sistema:

    macOS / Linux (Terminal)

    curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | sh

    Windows (PowerShell)

    irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

    El instalador:

    • detecta tu sistema operativo y arquitectura de CPU;
    • encuentra la última versión estable en Versiones de GitHub y la descarga mediante HTTPS;
    • verifica su checksum SHA-256 contra checksums.txt y se detiene si no coincide;
    • instala pbnode en ~/.local/bin (macOS, Linux) o %LOCALAPPDATA%\Programs\RepoFlow (Windows), sin permisos de administrador;
    • ejecuta pbnode version y comprueba que git y rg estén instalados.

    Nunca solicita credenciales ni inicia sesión por ti. En macOS y Linux no edita tus archivos de shell: si~/.local/bin no está en tu PATH, te indica qué añadir. En Windows añade su carpeta al PATH de tu usuario y lo informa (establece REPOFLOW_NO_MODIFY_PATH=1 para omitirlo).

    Opciones y lectura previa del script

    Lee los scripts antes de ejecutarlos: install.sh —install.ps1. Fija una versión o cambia el destino con variables de entorno(sustituye vX.Y.Z por un tag de Versiones):

    curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | REPOFLOW_VERSION=vX.Y.Z REPOFLOW_INSTALL_DIR="$HOME/bin" sh
    $env:REPOFLOW_VERSION = 'vX.Y.Z'; irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

    Las versiones publicadas antes de que la CLI pasara de repoflow a pbnode no incluyen pbnode: el instalador se detiene con un mensaje claro y no instala nada. Sus archivos originales siguen disponibles en Versiones.

    ¿Prefieres no pasar un script a tu shell? Sigue la instalación manual.

  2. Verificar

    Abre una terminal nueva y comprueba la versión instalada:

    pbnode version

    Muestra la versión, el commit, la fecha de compilación y la plataforma, por ejemplo PlanBefore Node vX.Y.Z y Platform: darwin/arm64.

  3. Inicializar

    pbnode init

    Crea la configuración local: un nombre para este Node (tu hostname) y la dirección de PlanBefore Hub. Todavía no se comparte nada. El archivo está en ~/Library/Application Support/RepoFlow (macOS), ~/.config/repoflow (Linux) o %AppData%\RepoFlow (Windows).

  4. Autenticar el Node

    pbnode login

    La terminal muestra un enlace y un código de un solo uso:

    Open:
https://auth.kvnlabs.xyz/device

Code:
ABCD-EFGH

    Abre el enlace, inicia sesión en PlanBefore Auth con tu passkey, comprueba que el código coincida y aprueba el Node. La terminal confirmará ✓ Node authorized. Puedes aprobarlo desde cualquier dispositivo donde tengas tu passkey: si el Node corre en un servidor o una máquina virtual sin ella, abre el enlace en tu ordenador o tu teléfono y escribe allí el código.

    Nunca escribes una contraseña ni un token en la CLI. La clave privada del Node se genera en tu equipo y se guarda en el almacén de credenciales del sistema (Keychain, Credential Manager o Secret Service). Puedes cambiar el nombre del Node o revocarlo desde tu cuenta.

  5. Exponer un proyecto

    cd ~/Projects/my-project
pbnode expose .
    • Solo los proyectos que expones explícitamente están disponibles para clientes MCP.
    • PlanBefore nunca expone todo tu sistema de archivos y excluye por defecto archivos como .env, claves privadas y credenciales.
    • Lista tus proyectos con pbnode projects; deja de compartir uno con pbnode revoke <project-id>.

  6. Iniciar el Node

    pbnode serve --background

    El Node se conecta de forma saliente a PlanBefore Hub —sin puertos abiertos ni VPN— y continúa funcionando después de cerrar la terminal. Deténlo con pbnode stop. Después de reiniciar, ejecuta el comando de nuevo.

  7. Comprobar el estado

    pbnode status

    Muestra este Node, el Hub al que se conecta, cuántos proyectos están habilitados y si el servicio en segundo plano está funcionando.

Conecta un cliente MCP

Añade PlanBefore como servidor MCP remoto en cualquier cliente compatible con autorización OAuth (por ejemplo, ChatGPT):

URL del servidor MCP
https://mcp.kvnlabs.xyz/repoflow
Autenticación
OAuth
Servidor de autorización
https://auth.kvnlabs.xyz (descubierto automáticamente)
https://mcp.kvnlabs.xyz/repoflow

El cliente te dirige a PlanBefore Auth para iniciar sesión con tu passkey y aprobar el acceso. Después pídele que liste tus proyectos (projects.list) y abra uno (project.tree, file.read).

Instalación manual

No interviene ningún script. Los ejemplos usan Linux x86_64; sustituye linux_amd64 por tu plataforma.

  1. Descarga el archivo de tu plataforma y checksums.txt desdepágina de descarga o Versiones de GitHub.
  2. Verifica el checksum — la salida debe coincidir con la línea de tu archivo en checksums.txt:
    # Linux
sha256sum --ignore-missing -c checksums.txt
# macOS
shasum -a 256 pbnode_*_darwin_arm64.tar.gz
    # Windows (PowerShell)
Get-FileHash .\pbnode_*_windows_amd64.zip -Algorithm SHA256
  3. Extráelo:
    tar -xzf pbnode_*_linux_amd64.tar.gz
    # Windows (PowerShell)
Expand-Archive .\pbnode_*_windows_amd64.zip -DestinationPath .
  4. Muévelo a una carpeta de tu PATH:
    mkdir -p ~/.local/bin
mv pbnode ~/.local/bin/

    En Windows, mueve pbnode.exe a %LOCALAPPDATA%\Programs\RepoFlow y añade esa carpeta al Path de tu usuario en Configuración → Sistema → Acerca de → Configuración avanzada del sistema → Variables de entorno.

  5. Comprueba que funciona: pbnode version, y continúa con el paso 3.

Binarios sin firma. Las compilaciones de PlanBefore todavía no tienen firma de código ni notarización. Si macOS bloquea un archivo descargado con un navegador, verifica el checksum y ejecuta xattr -d com.apple.quarantine ~/.local/bin/pbnode. En Windows, SmartScreen puede advertir sobre una aplicación no reconocida: elige Más información → Ejecutar de todas formas o ejecuta Unblock-File .\pbnode.exe.

Solución de problemas

pbnode: command not found

La carpeta de instalación no está en tu PATH. Para zsh (en bash usa ~/.bashrc), y luego abre una terminal nueva:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

Actualización

Ejecuta de nuevo el comando de instalación. Si el Node estaba funcionando, reinícialo con pbnode stop y pbnode serve --background. Tu configuración e identidad del Node se conservan.

El cliente MCP no puede ver un proyecto

Comprueba que pbnode status muestre el servicio funcionando y el proyecto habilitado, y que hayas iniciado sesión en el cliente con la misma cuenta de PlanBefore que autorizó el Node.