@donna-orchestrator/bridge
v0.2.21
Published
Apple Platform Bridge — runtime + CLI that connects a developer Mac to a Donna orchestrator and executes Apple-platform stages (Xcode / Swift) only. Refuses non-Apple dispatches with runner:scope_violation.
Readme
@donna-orchestrator/bridge
Apple Platform Bridge — a small thin-client that connects a developer Mac to a Donna orchestrator and executes Apple-platform stages only (Xcode / Swift / xcodebuild).
The bridge is not a general-purpose macOS runner. It refuses non-Apple
dispatches with runner:scope_violation so it can stay narrowly scoped to the
one workload Docker can't host: building and testing iOS / macOS / watchOS /
tvOS / visionOS apps that need a real Xcode + signed simulator. For a full
runner that handles any stage, wait for issue #85.
Install
npm install -g @donna-orchestrator/bridgeThe package only installs on darwin (os: ["darwin"] in package.json). It
requires Node >=22.
Pair against an orchestrator
Two pairing flows are supported:
# Same-Mac install — talks to a local orchestrator over loopback, no code:
donna-bridge install --orchestrator http://127.0.0.1:4000 --local-pair
# Remote orchestrator — paste the 6-digit code shown in Settings → Runners:
donna-bridge install --orchestrator https://donna.example.com --pairing-code 123456The installer registers a LaunchAgent that keeps the bridge running across
reboots. donna-bridge status shows the agent's state; donna-bridge logs
--follow tails the log file.
Documentation
See docs/apple-platform-bridge/getting-started.md
for the full setup walkthrough, troubleshooting, and migration notes.
License
Same as Donna (MIT).
