Support

Questions, bugs or ideas? Email stephen@bushelapp.org. I read everything.

Sources

Bushel counts tokens from three places. It only reads them and never changes anything.

• Claude Code: your .claude folder.
• Claude in Xcode: Xcode's ClaudeAgentConfig folder.
• Claude app: your Cowork sessions. Chats in the Claude app aren't saved on your Mac, so Bushel can't count them.

When Bushel opens for the first time, click Allow Access. The folder picker opens at your .claude folder, so you just click Allow. To add the others, click Connect next to each one in the welcome window or in Settings › Sources. Use Change… if a folder is somewhere else.

macOS asks once per folder. If you use Claude Code in more than one place, each response is still counted once.

Plan limits

Claude Code shares your 5-hour and weekly limits only with its status line. So Bushel needs one setting there, which saves a copy of the limits in your .claude folder.

1. Open Bushel's Settings and go to Sources › Limit sources.
2. Click Copy Setting, then Open settings.json.
3. Paste the setting into the file and save it.

• Limits only show on Pro and Max plans.
• They show up after the first response in a Claude Code session.
• For now, only the Claude Code CLI, in a terminal, reports them. Claude Code in the Claude app has no status line, so it can't. Your Claude app usage still counts toward the same limits.
• The setting replaces any status line you already have.
• If another tool manages your status line, it may replace the setting. Add it again if your limits stop updating.

Widgets

Control-click the desktop, choose Edit Widgets, and search for Bushel. Pick small, medium or large.

To choose what a widget shows, Control-click it and choose Edit "Bushel". You can show plan limits or your top models, and pick 7 days, 30 days or all time.

Widgets set to plan limits show your top models until Bushel has limits to show. See Plan limits to set them up.

If a widget says Open Bushel, Bushel isn't running. Widgets show the numbers Bushel last saved, so open the app and they'll update.

Accessibility

• VoiceOver: every control has a label. In the heatmap, use the arrow keys to move between days and hear each day's tokens. The usage chart has an Audio Graph, so you can hear its shape.
• Higher contrast: turn it on in Settings › General, or turn on Increase contrast in System Settings › Accessibility › Display. Bushel then uses solid backgrounds, full-strength text, colors that are easier to tell apart with color blindness, and gaps between the parts of each bar.
• Color: each model's color always appears next to its name and numbers, and limits show their percentage as text.
• Dark mode: the popover, Settings and widgets follow your Mac's appearance.
• Voice Control: Bushel uses standard controls, but I haven't tested it with Voice Control yet. That's planned for the next update.

If something in Bushel is hard to use with your setup, email stephen@bushelapp.org. I'll fix it.

Questions

Why does Bushel ask for a folder?

Mac App Store apps can't read your files unless you let them. Bushel asks once per folder, only reads it, and remembers your choice.

Why are my numbers bigger than I expected?

Bushel counts cache tokens too, the same way Claude Code's old stats screen did. Cache reads are usually most of the total. The Models view breaks out input, output and cache for each model.

Does Bushel count my chats in the Claude app?

No. Chats aren't saved on your Mac, so there's nothing to count. Cowork sessions are saved, so those are counted once you connect the Claude app.

My older history is gone. Can I get it back?

Claude Code deletes old session files after a while. Bushel counts every session file still on your Mac and keeps the daily totals, so nothing it has counted is lost. If Claude Code's old stats file is still there, Bushel imports the days before that too.

How do I delete Bushel's data?

In Settings, choose Delete Saved History. To remove everything, see the privacy policy.

Still stuck?

Email stephen@bushelapp.org with your macOS version and what you're seeing. A screenshot helps.