# PluginBridge — Sync File > HF Claude builds. Claude Code: pull → build → paste error (if any). That's it. --- ## Claude Code Rules (TOKEN EFFICIENT MODE) **Your ENTIRE job is these commands:** ```bash cd ~/pluginbridge && git pull cd build && cmake --build . --config Release 2>&1 | tail -30 ``` **If build succeeds:** Reply "✅ build ok" — nothing else. **If build fails:** Reply with ONLY the first 3 errors: ``` ❌ [filename]:[line] — [one-line error message] ``` ## DO NOT: - Explain errors - Suggest fixes - Write code - Add commentary ## Architecture (Current) **Out-of-process hosting.** Two binaries: 1. `PluginBridge.vst3` — thin shell (audio bridge + MCP server), loaded in Ableton 2. `PluginBridgeHelper` — standalone exe bundled inside .vst3, hosts the actual plugin If a plugin crashes → only Helper dies → Ableton survives → UI shows "Reload" button. ## What Was Ditched - ❌ In-process plugin hosting (crashed Ableton with some plugins) - ❌ Plugin scanning via `PluginDirectoryScanner` (triggered NSAlert crashes) - ❌ `addDefaultFormats()` (deleted in JUCE 8) - ❌ `juce::Thread::setCurrentThreadPriority()` (removed in JUCE 8) - ❌ `MSG_NOSIGNAL` (doesn't exist on macOS) - ❌ `NSApplicationActivationPolicyAccessory` — broke fullscreen, reverted - ❌ `showAsFloatingPanel()` with objc_msgSend level hacks — broke fullscreen, reverted - ❌ `NSWindowCollectionBehavior` changes — didn't help, reverted - ❌ Window level 25 (NSStatusWindowLevel) — unnecessary, reverted ## What's Working - ✅ Out-of-process via shared memory + semaphores + Unix socket - ✅ Crash-safe — plugins that abort() only kill the helper - ✅ Plugin GUI via `setAlwaysOnTop(true)` — stays in same Space as Ableton (including fullscreen) - ✅ X button hides GUI (doesn't quit Helper) - ✅ Toggle GUI via button in PluginBridge panel (Open GUI / Close GUI) - ✅ Plugin list from filesystem (no binary loading until user selects) - ✅ Native pthread priority for audio thread ## Status **Last push:** 2026-05-16 — Fixed fullscreen issue. Root cause: commit 0632681 replaced `setAlwaysOnTop(true)` with objc_msgSend hacks that broke Space behavior. Fix: restored `setAlwaysOnTop(true)` + kept X button fix. **Build:** Needs test **Test:** Pull, build, Ableton fullscreen → Open GUI → should open in same Space. X button should hide (not quit). **Next:** Sprint 3 — MCP param control from Claude Code (curl tests)