Arc OS Docs Open in app →

Local Bridge — Configuración en macOS

Guía de instalación específica para macOS. Para el resumen general, la lista de verificación previa, errores, modelo de seguridad y diagnósticos, consulta Local Bridge — Guía de configuración.

Tiempo total: ~60 segundos asumiendo que ya copiaste el token.

Primero, identifica tu chip

Tu Mac Haz clic en este botón del CRM Archivo que obtienes
Apple Silicon (M1 / M2 / M3 / M4 / M5) macOS (Apple Silicon) bridge-darwin-arm64.tar.gz (~50 MB)
Intel (Mac anterior a 2020) macOS (Intel) bridge-darwin-x64.tar.gz (~50 MB)

¿No sabes qué chip tienes? Haz clic en el logo 🍎 (arriba a la izquierda) → About This Mac → busca "Chip: Apple M1/M2/M3/M4/M5" (Apple Silicon) o "Processor: Intel Core …" (Intel). Si no estás seguro: Apple Silicon — todos los Mac vendidos desde noviembre de 2020.

Los pasos a continuación son idénticos para ambos chips. Simplemente sustituye arm64 ↔ x64 en los nombres de carpetas y binarios.

1. Descarga

En el CRM: Settings → Integrations → Bridge Setup → 🍎 macOS (Apple Silicon) (o 🍏 para Intel).

Safari descarga bridge-darwin-arm64.tar.gz y lo extrae automáticamente en ~/Downloads/bridge-darwin-arm64/.

🎞️ GIF placeholder — media/bridge/macos-download.gif Especificación: grabación de pantalla de 8 segundos — el cursor hace clic en el botón 🍎 → la barra de progreso de Safari se llena → aparece una carpeta en el Finder.

La carpeta contiene:

bridge-darwin-arm64/
├── bridge-darwin-arm64    ← el binario
├── install.sh             ← script de shell (amigable con la terminal)
└── install.command        ← lanzador amigable con el Finder

2. Ejecuta el instalador

Forma fácil (Finder, sin Terminal)

🎞️ GIF placeholder — media/bridge/macos-rightclick-open.gif Especificación: grabación de 12 segundos — Finder abierto en ~/Downloads/bridge-darwin-arm64/, clic derecho en install.command, elegir Open en el menú, aparece el diálogo "developer cannot be verified", clic en Open, Terminal se abre con el instalador corriendo.

  1. Abre ~/Downloads/bridge-darwin-arm64/ en el Finder
  2. Clic derecho en install.command → Open
  3. Haz clic en Open en el diálogo "developer cannot be verified"
  4. La Terminal se abre y ejecuta el instalador automáticamente

❗ El clic derecho → Open es obligatorio en el primer inicio. Un doble clic normal activa el bloqueo total de Gatekeeper. Después del primer inicio exitoso, el doble clic funciona siempre.

Forma avanzada (Terminal)

cd ~/Downloads/bridge-darwin-arm64
bash install.sh

3. Conéctate

Antes de lanzar, obtén dos valores del CRM:

Qué Dónde
Token Settings → Integrations → Bridge Setup → clic en Copy (JWT, TTL 24h)
Nombre técnico del proyecto Sidebar → tu proyecto → slug de URL (por ejemplo, el de minúsculas con guiones, no el nombre visible)

El bridge te pedirá entonces tres valores:

Token (paste from CRM):  ⌘+V
Project name:             <project>
Server URL [enter for default]:  presiona ⏎

🖼️ Screenshot placeholder — media/bridge/macos-connected.png Especificación: ventana de Terminal tras la conexión. Líneas visibles: ✓ Token validated · ✓ Connected to ws://…/ws/local-bridge · Watching <abs-path>. El título de la ventana muestra Terminal — install.command.

P: ¿Por qué un nombre de proyecto si tengo varios? Una instancia de bridge se asocia a un proyecto — los workers de ese proyecto solo leen archivos del directorio desde donde lanzaste el bridge (en sandbox). Para trabajar con varios proyectos, ejecuta un bridge por proyecto en su propio directorio.

P: ¿Para qué sirve la URL del servidor? Simplemente pulsa Enter. La URL por defecto apunta al relay de producción de Arc OS. La URL personalizada es para configuraciones autoalojadas; no necesitas tocarla.

Si ves ✓ Connected, ya terminaste. Cambia al CRM → Bridge Setup y confirma el punto verde.

❌ Tres cosas que NO debes hacer en macOS

🖼️ Screenshot placeholder — media/bridge/macos-damaged-error.png Especificación: diálogo de macOS "bridge-darwin-arm64" is damaged and can't be opened. con botones Move to Trash / Cancel. Anotación: X roja sobre Move to Trash, marca verde sobre Cancel.

No hagas Por qué En su lugar
Doble clic directo en bridge-darwin-arm64 Gatekeeper lo marca como "damaged" — confuso pero esperado para binarios sin firma Ejecuta primero install.command; elimina el atributo de cuarentena
Hacer clic en "Move to Trash" en el diálogo de damaged Pierdes el binario descargado Haz clic en Cancel y usa install.command
Arrastrar la carpeta a Aplicaciones El bridge necesita ejecutarse desde donde lo lanzaste (raíz del sandbox) Ejecútalo directamente desde ~/Downloads/bridge-darwin-arm64/

Ejecutar en segundo plano (daemonizar)

nohup ./bridge-darwin-arm64 > bridge.log 2>&1 &

Un modo de servicio persistente (launchd) está en el roadmap — ver Phase 23.4.

Qué sigue