Skip to content
Threadbear
What it does How it works FAQ Docs
Get Threadbear
  • Home
  • What it does
  • How it works
  • FAQ
  • Docs
  • Get Threadbear
Using Threadbear
  1. Threads
  2. Full access or Ask before edits
  3. Your first thread
  4. Hibernate and archive
  5. Panels
  6. Highlights
  7. Schedules
  8. Accounts, pools and Usage
  9. Connectors
  10. The prompts macOS shows you
  11. Your phone and a browser
  12. Patches: your own buttons and panels
  13. Changing Threadbear itself
  14. Privacy
  15. Getting help
  16. The tour and Finish setting up

Accounts, pools and Usage

Threadbear uses the Claude Code and Codex logins already on your Mac: the Claude Code login in ~/.claude and the Codex login in ~/.codex. It never reads their passwords or tokens. The account and model a thread runs on are small menus on the composer. Whatever you picked last is what the next thread starts on.

Logins are grouped into pools, one for Claude and one for Codex to begin with (Settings > Pools). A thread in a pool runs on whichever login has the most room. When the one it's on gets close to its limit, it moves to another login in the pool with room, and carries on from where it was. When none has room, the thread waits and carries on by itself once a limit resets. With only one login, that means it waits for that login's limit to reset.

Usage, near the bottom of the left-hand rail, shows how much room each login has left before it hits its limits (for Claude, the 5-hour and weekly ones). Threadbear learns these numbers from the threads it runs, so a login's bars fill in once it has run something.

At the top it shows what you've spent: tokens today (and what a usual day had spent by this time), in the last hour and over the last 7 days, with a chart by the hour or by the day, each login in its own colour. Hover a bar to see who spent what. The tokens are read from the Claude and Codex transcripts on your Mac, so work done outside Threadbear counts too; the first read takes a minute or so after the runner updates.

Below that, each pool is a card, with each login in it: what it's spent today, and its 5-hour and weekly windows. The weekly one has a small chart of the week so far, with your current pace dashed on to the reset. When a window would run out before it resets at that pace, it says when in orange. Hover a window for its rate.

Next: Connectors

Threadbear is made by Mike Cann. It runs the official Claude Code and Codex command line tools, and isn't made by or connected to Anthropic or OpenAI.

Home How it works FAQ Docs Help Privacy mikecann.app