Saltar al contenido
PaneflowPaneflow
Docs

Instalar Paneflow en macOS

Instala Paneflow en un Mac Apple Silicon con macOS 13 Ventura o posterior. Elige Homebrew o el DMG, verifica la instalación y configura el acceso desde el terminal.

Paneflow requiere macOS 13 Ventura o posterior en un Mac Apple Silicon. Usa Homebrew si ya lo tienes instalado, o descarga el .dmg para una instalación manual. Ambos métodos instalan PaneFlow.app, firmado y notarizado. No necesitas Rust ni herramientas de compilación.

¿Cómo instalo Paneflow con Homebrew?

Abre el terminal e instala el cask de Paneflow:

bash
brew install --cask arthjean/paneflow/paneflow

Homebrew instala PaneFlow.app en /Applications por defecto. Si no se encuentra el comando brew, usa las instrucciones de DMG más abajo. También puedes usar el DMG si Homebrew todavía no ofrece una versión recién publicada.

¿Cómo instalo Paneflow desde un DMG?

Abre la última versión de Paneflow en GitHub, o ejecuta este comando para abrir la página de la versión en el navegador:

bash
open https://github.com/arthjean/paneflow/releases/latest
  1. Descarga el archivo paneflow-<version>-aarch64-apple-darwin.dmg. <version> corresponde al número de versión que aparece en la página.
  2. Abre el .dmg descargado en Finder.
  3. Arrastra PaneFlow.app al acceso directo Applications de la imagen de disco.
  4. Espera a que termine la copia y expulsa la imagen de disco.

Abre Paneflow

Abre PaneFlow.app desde Aplicaciones, o usa Spotlight (Cmd+Space, y después escribe PaneFlow). También puedes iniciar la aplicación desde el terminal:

bash
open -a PaneFlow

Si macOS te pide confirmar la apertura de una aplicación descargada de internet, elige Abrir para la copia que acabas de instalar. Para otras alertas, sigue las instrucciones de Gatekeeper más abajo.

¿Cómo verifico la instalación?

Ejecuta directamente el binario instalado:

bash
/Applications/PaneFlow.app/Contents/MacOS/paneflow --version

El comando debe mostrar la versión instalada. Comprueba también que la aplicación se abra. Si no se encuentra el archivo, comprueba que PaneFlow.app esté en /Applications o repite la instalación.

Después, sigue la guía de primeros pasos para iniciar tu primer agente. Instala los agentes CLI por separado y sigue sus instrucciones de inicio de sesión.

Usa el comando paneflow en el terminal

Instalar la aplicación no añade automáticamente el binario al PATH de tu shell. Prueba primero paneflow --version. Si muestra la versión instalada, omite esta sección.

Si no funciona, crea un enlace simbólico al binario instalado. Estos comandos crean /usr/local/bin si hace falta y conservan cualquier entrada paneflow existente:

bash
sudo mkdir -p /usr/local/bin
sudo ln -s /Applications/PaneFlow.app/Contents/MacOS/paneflow /usr/local/bin/paneflow
/usr/local/bin/paneflow --version

Si ln muestra File exists, comprueba la entrada con ls -l /usr/local/bin/paneflow. Si ya apunta a la aplicación instalada, omite el comando de creación del enlace. Si apunta a otra ubicación, usa la ruta completa indicada en la sección de verificación.

Si la ruta completa funciona pero no se encuentra paneflow, añade /usr/local/bin al PATH de tu shell. En Bash o Zsh, ejecuta export PATH="/usr/local/bin:$PATH" y vuelve a probar paneflow --version. Para conservar el ajuste en nuevos terminales, añade la misma línea a ~/.zshrc para Zsh o a ~/.bash_profile para shells de inicio de sesión Bash.

¿Qué pasa si macOS bloquea PaneFlow.app?

El DMG oficial está firmado y notarizado. Si macOS no puede verificar al desarrollador, descarga primero una copia nueva desde la página de la versión indicada arriba. Si has verificado su origen y sigue bloqueada, sigue las instrucciones de Apple para abrir una aplicación bloqueada:

  1. Intenta abrir PaneFlow.app una vez.
  2. Abre Ajustes del Sistema y después Privacidad y seguridad.
  3. Busca el aviso de PaneFlow.app y selecciona Abrir igualmente.
  4. Confirma con Abrir en el siguiente diálogo.

Si la opción no está disponible en un Mac gestionado, contacta con tu administrador. Si macOS indica que la aplicación está dañada o dañará tu ordenador, mantenla bloqueada e informa del problema de instalación en GitHub. Incluye la alerta exacta, tu versión de macOS y la versión de Paneflow.

¿Y los Mac Intel?

Paneflow no publica una versión de macOS para Intel. El DMG para Apple Silicon no funciona en un Mac Intel. La guía de instalación en Linux y la guía de instalación en Windows describen las versiones y los procesadores compatibles con esos sistemas.