Instala PlanBefore

De la descarga a un Node funcionando en siete pasos. No necesitas 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://mcp.kvnlabs.xyz/device
    
    Code:
    ABCD-EFGH

    Abre el enlace de PlanBefore Hub, inicia sesión con tu passkey de PlanBefore Auth, comprueba que el código coincida y aprueba el Node en el Hub. 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. Conecta un proyecto

    cd ~/Projects/my-project
    pbnode expose .
    • Solo los proyectos que expones explícitamente están disponibles para asistentes autorizados.
    • 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>.

    ¿También quieres planificación?

    Puedes autorizar una carpeta dentro del proyecto para guardar Requerimientos Funcionales, tareas y revisiones:

    pbnode expose . --spec-root specs

    Esta capacidad no es necesaria para utilizar PlanBefore únicamente como herramienta de análisis.

    Habilita la ejecución de tareas

    Si quieres que PlanBefore implemente las tareas que apruebes, instala Codex en tu equipo. No necesitas configurar nada más: si codex está en tu PATH, la ejecución queda disponible. Solo si Codex no está en tu PATH, indica su ruta con executor.command en la configuración del Node. pbnode status muestra si la ejecución de tareas está disponible. Codex trabaja directamente sobre tu proyecto en tu equipo; PlanBefore sigue la ejecución y devuelve el resultado al asistente para su revisión.

    Hoy la ejecución integrada utiliza Codex. Próximamente, PlanBefore ampliará la compatibilidad a Claude Code y otros agentes de desarrollo locales.

  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 tu asistente de IA

Añade PlanBefore a ChatGPT, Claude, Gemini u otro asistente compatible y autoriza el acceso desde tu cuenta de PlanBefore.

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

Después de conectarlo, pídele al asistente que liste tus proyectos o que analice uno de ellos. Si configuraste una carpeta de planificación, también podrás utilizar PlanBefore para crear Requerimientos Funcionales y tareas.

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.

Tu asistente de IA no puede ver un proyecto

Comprueba que pbnode status muestre el servicio funcionando y el proyecto habilitado, y que hayas autorizado al asistente con la misma cuenta de PlanBefore que autorizó el Node.

¿Sigues con problemas? Consulta Soporte.