Local Bridge — Встановлення на macOS

Інструкція з налаштування для macOS. Загальний огляд, чек-лист, помилки, безпека та діагностика — на сторінці Local Bridge — головний гайд.

Загальний час: ~60 секунд за умови, що токен уже скопійовано.

Спочатку обери чип

Твій Mac	Тисни в CRM	Отримаєш файл
Apple Silicon (M1 / M2 / M3 / M4 / M5)	macOS (Apple Silicon)	bridge-darwin-arm64.tar.gz (~50 МБ)
Intel (Mac до 2020 року)	macOS (Intel)	bridge-darwin-x64.tar.gz (~50 МБ)

Не знаєш, який чип? Клікни на 🍎 у верхньому лівому куті → About This Mac → шукай "Chip: Apple M1/M2/M3/M4/M5" (Apple Silicon) або "Processor: Intel Core …" (Intel). Якщо сумніваєшся: Apple Silicon — будь-який Mac, проданий з листопада 2020 року.

Кроки нижче ідентичні для обох чипів. Просто заміни arm64 ↔ x64 у назвах папок і бінарників.

1. Завантаж

У CRM: Settings → Integrations → Bridge Setup → 🍎 macOS (Apple Silicon) (або 🍏 для Intel).

Safari завантажить bridge-darwin-arm64.tar.gz і автоматично розпакує його в ~/Downloads/bridge-darwin-arm64/.

🎞️ Місце для GIF — media/bridge/macos-download.gif Специфікація кадру: 8-секундний запис екрана — курсор тисне на 🍎 кнопку → індикатор завантаження Safari заповнюється → у Finder з'являється папка.

Папка містить:

bridge-darwin-arm64/
├── bridge-darwin-arm64    ← the binary
├── install.sh             ← shell script (terminal-friendly)
└── install.command        ← Finder-friendly launcher

2. Запусти інсталятор

Простий шлях (Finder, без Terminal)

🎞️ Місце для GIF — media/bridge/macos-rightclick-open.gif Специфікація кадру: 12-секундний запис — Finder відкритий на ~/Downloads/bridge-darwin-arm64/, правий клік на install.command, вибір Open із меню, з'являється діалог "developer cannot be verified", клік Open, запускається Terminal з інсталятором.

1. Відкрий ~/Downloads/bridge-darwin-arm64/ у Finder
2. Правий клік на install.command → Open
3. Тисни Open у діалозі "developer cannot be verified"
4. Terminal автоматично запустить інсталятор

❗ Правий клік → Open обов'язковий під час першого запуску. Звичайний подвійний клік активує жорстку блокіровку Gatekeeper. Після першого успішного запуску подвійний клік працюватиме завжди.

Шлях для досвідчених (Terminal)

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

3. Підключайся

Перед запуском візьми дві речі з CRM:

Далі bridge запитає три значення:

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

🖼️ Місце для скриншоту — media/bridge/macos-connected.png Специфікація кадру: вікно Terminal після підключення. Видимі рядки: ✓ Token validated · ✓ Connected to ws://…/ws/local-bridge · Watching <abs-path>. Заголовок вікна — Terminal — install.command.

Q: Навіщо назва проєкту, якщо в мене їх декілька? Один інстанс bridge приєднаний до одного проєкту — воркери цього проєкту читають файли тільки з тієї директорії, з якої ти запустив bridge (sandboxed). Якщо працюєш з кількома проєктами — запускай по одному bridge на проєкт із його власної директорії.

Q: Навіщо Server URL? Просто тисни Enter. Дефолт указує на production-релей Arc OS. Кастомна URL потрібна тільки для self-hosted інсталяцій; чіпати не треба.

Якщо бачиш ✓ Connected, готово. Перейди в CRM → Bridge Setup і переконайся, що горить зелена крапка.

❌ Три речі, яких НЕ варто робити на macOS

🖼️ Місце для скриншоту — media/bridge/macos-damaged-error.png Специфікація кадру: діалог macOS "bridge-darwin-arm64" is damaged and can't be opened. із кнопками Move to Trash / Cancel. Анотація: червоний хрестик над Move to Trash, зелена галочка над Cancel.

Запуск у фоні (daemon)

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

Постійний сервіс-режим (launchd) у дорожній карті — див. Phase 23.4.

Куди далі

• ⬅ Повернутися на головну — помилки, безпека, діагностика та секція "Що насправді робить Bridge"
• Встановлення на Linux
• Встановлення на Windows