๐ฆ
NowBat Support
Answers to the common questions โ and a bat-signal for everything else.
Getting started
How does NowBat know my Claude limits?
Two honest ways. โ Run
/usage in Claude Code (or open claude.ai โ Settings โ Usage), copy the panel, and NowBat offers to apply it the moment you open the app โ it reads the exact percentages and reset times. โก Tap Start when you send your first message and NowBat counts the 5 hours itself. On a Mac, the companion does all of this automatically. There is no Anthropic API for limits โ any app claiming to read them live without one of these methods is guessing.What do the bat’s moods mean?
Hanging asleep = your window is burning, let it work. One eye open = under 15 minutes to reset. Awake with wings out = it’s your turn. Wrapped up and sulking = the weekly cap is spent. Tap the bat โ each mood reacts differently.
What’s the kickoff queue?
A place to jot tasks while your window is burning. When it resets, one tap composes everything โ project, repo path, branch, numbered tasks โ into a markdown block ready to paste into a fresh Claude session.
The Mac companion
How does the Mac app set timers automatically?
It reads Claude Code’s local transcript files (
~/.claude) on your Mac, works out when your window started from your own message timestamps, estimates burn, and syncs it all to your iPhone and iPad through iCloud. Nothing leaves your machine except through your own iCloud account.The Mac app asked for access to a folder โ why?
The Mac App Store version runs in Apple’s sandbox, so it needs one-time permission to read the
.claude folder. The picker opens in the right place โ just press Grant Access. If you ever move or recreate the folder, grant it again from Settings โ Mac companion.The estimated percentage looks wrong.
The estimate calibrates itself against ground truth: paste a real
/usage panel once (on any device) and NowBat learns your plan’s actual budget โ including temporary limit boosts. It gets accurate within a paste or two.Sync, Pro & purchases
How do I sync between iPhone, iPad and Mac?
Settings โ iCloud Sync โ on, on each device, then relaunch each once. It’s off by default โ until you enable it, everything stays on the device. Sync uses your own iCloud; NowBat has no servers and no login.
What’s in NowBat Pro?
The full pomodoro suite (window-sized focus chains, task linking, focus noise, stats), Mac auto-sync, multiple accounts, burn prediction, cost analytics, iCloud sync, calendar-fitted focuses, and four extra bat faces. One $14.99 purchase, family-shareable, valid on iPhone, iPad and Mac together. No subscription, ever.
I bought Pro โ how do I get it on my other devices?
Same Apple Account: open Settings โ Restore purchase on the other device. Family Sharing members can restore it the same way.
Troubleshooting
Notifications aren’t arriving.
Check iOS Settings โ Notifications โ NowBat โ Allow. Then in NowBat’s Settings, confirm Reset reminders is on. Focus modes can silence alerts โ add NowBat to your allowed apps for that Focus.
The Live Activity doesn’t show.
iOS Settings โ NowBat โ Live Activities โ on, and make sure a window is actually burning (it appears when a countdown is active and ends at reset).
The widget says โas of 2h agoโ.
That’s honesty, not a bug โ the percentage is from your last paste or Mac sync. Open the app (or let the Mac companion refresh) to update it.
Still stuck?
Email and a human โ the one who drew the bat โ will reply.
Email support