[jaibhasin]

Readflow now appears only after clicking its Chrome toolbar icon, and the Python bridge can run only while the native Readflow Mac app is open.
Opening the app starts the bridge; quitting or closing its window stops it, with an EOF pipe also preventing an orphaned bridge if the app exits unexpectedly.

The app installs in the user Applications folder, uses the permanent checkout and its existing .env, and includes a cassette icon, readiness status, retry controls, and startup logs.
The README explains installation and removing the optional always-on login service.
This PR includes and supersedes the changes in #12, including the browser recovery test fix.

Validation:

• Type check and extension build passed.
• All 117 JavaScript tests and all 6 Python tests passed.
• Real Chrome playback checks passed, including frozen-tab pause and saved-position recovery.
• Native macOS build and signature verification passed.
• Installed app launch, Quit, and window-close behavior verified locally; the bridge process and listener disappear after quitting.
• Added macOS CI coverage for app compilation, icon packaging, signature verification, and Python lifecycle tests.

The app was installed locally and the login service removed.
After merging and pulling, rebuild and reload the extension to get the toolbar behavior; the installed Mac app is already ready to use on this Mac.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

• Configuration used: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: 3ac48ab6-82b7-4bd9-ab26-a55533b157f5

---

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

---

_{Comment @coderabbitai help to get the list of available commands.}