Support

Let’s get it working.

Start with the quick checks below. If the issue persists, the GitHub issue tracker is the best place to get help.

Why will the app not install or update?

Limit Lifeboat requires an Apple Silicon Mac running macOS 14 Sonoma or newer; Intel Macs are not supported. For the DMG, drag the app into Applications before opening it. The app checks for updates daily by default and never installs one silently — every update waits for you to choose Install and Relaunch. Replacing the app in Applications preserves its Application Support and Keychain data.

  • Version 1.1.3 quits immediately after updating. Install 1.1.4 or newer over it to recover.
Install instructions

Why is an account missing or showing an old reading?

Accounts register themselves from your existing CLI logins. Sign in with claude or codex login in Terminal, then refresh the app and the active account appears. An inactive account keeps its last successful reading and shows the age of that reading rather than presenting it as live. Readings older than 30 minutes are marked stale. If a saved login has expired, use that account's Log In or Retry action.

Why usage numbers disagree

Why did a CLI switch fail or prompt me?

Switching changes the selected CLI login only — not your browser session and not the desktop app. A first switch may ask for macOS Terminal Automation permission. If another process changed the credentials while the switch was running, that external change wins and the switch aborts rather than overwriting it; retry once the other process has finished. If a rollback was not safe, the app keeps a protected recovery directory and tells you where it is.

What a switch actually writes

Which macOS permissions does it need?

All of them are optional and none are requested until you use the feature that needs them. Notifications can be changed at any time in System Settings. Launch at login stays off until you enable it in Settings. Keychain prompts appear only for explicit actions that require authorization. Terminal Automation is requested the first time you switch.

Privacy details

Before reporting a bug

A few details speed up the diagnosis.

Include the Limit Lifeboat version, your macOS version, the affected provider, what you expected, what happened, and the smallest sequence that reproduces it. The app’s Settings window has a Copy Diagnostics button that gathers most of this for you.

Remove secrets first

Never attach real access tokens, refresh tokens, cookies, passwords, private keys, full Keychain exports, or unredacted account data.

Security issue?

Report it privately.

Do not open a public issue for an undisclosed vulnerability. GitHub private vulnerability reporting keeps the details between you and the maintainer while the issue is investigated.

Submit a private report