feat(companion): add runnable macOS menu-bar reference app scaffold

2026-02-26 20:51:00 -08:00
parent 3f6232d1fb
commit d303869866
21 changed files with 695 additions and 13 deletions
@@ -0,0 +1,21 @@
+# Flynn macOS Companion Menu Bar App (Reference MVP)
+
+This is a runnable Swift Package reference app that creates a macOS menu bar companion controller.
+
+## Capabilities
+
+- Loads companion.bootstrap.json from package resources.
+- Starts/stops flynn companion as a child process from menu actions.
+- Runs one-shot handoff prompts (flynn companion --once --handoff ...).
+- Shows process state in the menu bar title (F, F* running, F! error).
+
+## Build + Run
+
+Run:
+cd <this-directory>
+swift run FlynnCompanionMenuBar
+
+Prerequisites:
+
+- macOS with Swift toolchain.
+- flynn executable available in PATH.