flynn/apps/companion/macos-app/README.md

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 swift run FlynnCompanionMenuBar

Prerequisites:

• macOS with Swift toolchain.
• flynn executable available in PATH.