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).
gityrg(ripgrep) en tuPATH. 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 -eInstalar
Ejecuta el instalador de tu sistema:
macOS / Linux (Terminal)
curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | shWindows (PowerShell)
irm https://planbefore.kvnlabs.xyz/install.ps1 | iexEl 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.txty se detiene si no coincide; - instala
pbnodeen~/.local/bin(macOS, Linux) o%LOCALAPPDATA%\Programs\RepoFlow(Windows), sin permisos de administrador; - ejecuta
pbnode versiony comprueba quegityrgestén instalados.
Nunca solicita credenciales ni inicia sesión por ti. En macOS y Linux no edita tus archivos de shell: si
~/.local/binno está en tuPATH, te indica qué añadir. En Windows añade su carpeta alPATHde tu usuario y lo informa (estableceREPOFLOW_NO_MODIFY_PATH=1para 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.Zpor 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 | iexLas versiones publicadas antes de que la CLI pasara de
repoflowapbnodeno incluyenpbnode: 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.
Verificar
Abre una terminal nueva y comprueba la versión instalada:
pbnode versionMuestra la versión, el commit, la fecha de compilación y la plataforma, por ejemplo
PlanBefore Node vX.Y.ZyPlatform: darwin/arm64.Inicializar
pbnode initCrea 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).Autenticar el Node
pbnode loginLa terminal muestra un enlace y un código de un solo uso:
Open: https://mcp.kvnlabs.xyz/device Code: ABCD-EFGHAbre 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.
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 conpbnode 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 specsEsta 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
codexestá en tuPATH, la ejecución queda disponible. Solo si Codex no está en tuPATH, indica su ruta conexecutor.commanden la configuración del Node.pbnode statusmuestra 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.
Iniciar el Node
pbnode serve --backgroundEl 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.Comprobar el estado
pbnode statusMuestra 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/repoflowDespué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.
- Descarga el archivo de tu plataforma y
checksums.txtdesdepágina de descarga o Versiones de GitHub. - 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 - Extráelo:
tar -xzf pbnode_*_linux_amd64.tar.gz# Windows (PowerShell) Expand-Archive .\pbnode_*_windows_amd64.zip -DestinationPath . - Muévelo a una carpeta de tu
PATH:mkdir -p ~/.local/bin mv pbnode ~/.local/bin/En Windows, mueve
pbnode.exea%LOCALAPPDATA%\Programs\RepoFlowy añade esa carpeta alPathde tu usuario en Configuración → Sistema → Acerca de → Configuración avanzada del sistema → Variables de entorno. - 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"' >> ~/.zshrcActualizació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.