Support

Get help with MenuOps setup and troubleshooting

Getting Started

1. Create a GitHub Personal Access Token — Go to GitHub Settings > Developer Settings > Personal Access Tokens > Fine-grained tokens. Create a token with repo and actions:read permissions for the repositories you want to monitor.
2. Add your account — Open MenuOps from the menu bar, click the gear icon, and add your GitHub account with the token you created.
3. Add repositories — Select repositories to monitor from the dropdown. MenuOps will start polling for workflow status immediately.
4. You're set — MenuOps will show a green dot when all workflows pass, yellow when running, and red when something fails. You'll get native macOS notifications for status changes.

Frequently Asked Questions

What GitHub permissions does MenuOps need?

MenuOps needs a Personal Access Token with repo scope and actions:read permission. This allows it to read workflow run status. MenuOps never reads your code, writes to repositories, or accesses anything beyond workflow and pull request metadata.

How often does MenuOps check for updates?

Free users get updates every 60 seconds via polling. Premium subscribers get real-time push notifications (typically under 5 seconds) with a 5-minute polling fallback for reliability.

Does MenuOps work with GitHub Enterprise?

Yes. When adding an account, enter your GitHub Enterprise Server URL instead of the default github.com.

How do I manage my premium subscription?

Subscriptions are managed through the Mac App Store. Go to App Store > your account > Subscriptions to change or cancel your plan. Cancellations take effect at the end of the current billing period.

Why am I not getting notifications?

Check that notifications are enabled for MenuOps in System Settings > Notifications. If you're a premium subscriber, also ensure push notifications are allowed. MenuOps sends notifications when a workflow changes state (e.g., from running to completed).

Does MenuOps use a lot of battery?

MenuOps is designed to be lightweight. Free users poll once per minute, which has minimal battery impact. Premium subscribers use push notifications, which are even more efficient since the app only wakes when there's an actual status change.

Can I monitor multiple GitHub accounts?

Premium subscribers can add multiple GitHub accounts with different tokens. Free users can monitor repositories from a single account.

How do I uninstall MenuOps and remove my data?

Quit MenuOps, then drag it to the Trash. All local data (configuration, cached status) is removed with the app. Your GitHub token is stored in the macOS Keychain — you can remove it manually via Keychain Access if desired.

---

Contact Support

If you need help or want to report a bug, email us at support@menuops.dev. We typically respond within one business day.

For privacy-related inquiries, contact privacy@menuops.dev.