Even though you pay every month for your Claude plan, your quota is actually expires sooner than that. Quota is based 1) a 5-hour window that opens on your first prompt and resets five hours later, and 2) a weekly window.
The daily and weekly budget doesn't roll over! You've already paid for it, but that capacity simply disappears when the current session's 5 hour window is up.
This translates to:
- 40% of a typical day's 5-hour Claude quota expires.
- 12,000 lines of working code that idle capacity could write every week.
Imbue engineer Ev used their quota to find and fix bad tests in the mngr codebase. In a day, they were able to produced 9 merged PRs that added integration tests, fixed silently failing tests, and cleaned up code.
How to use it
Ev's workflow and all of their code is checked into our open source mngr repo.
1. Install mngr and the usage plugins
The default install of mngr doesn't include the usage plugin that monitors token usage. Add the plugin:
sh
2. Fork Ev's "fix bad tests" Claude skill, or write your own skill.
Ev's skill lives in our open source mngr repo. Then, add this custom skill to Claude.
3. Trigger mngr to check quota every 10 minutes, and run skill if there's spare capacity.
Schedule this script every 10 minutes on cron or LaunchAgent on macOS. The script does two things:
1) Use`mngr usage` to check the remaining Claude quota
2) If there's quota, start the agent using `mngr create`.
This script defines "budget to spare" as when the 5h window has <80% used budget *and* weekly usage is below a line that starts ~30% under the plain `used% = how_much_the_cycle_has_elapsed%` pace early in the rolling 7-day cycle and tapers up to meet it by the cycle's end. But you’re free to fork the script and customize it yourself - such is the power of open source software!
And that’s it! The skill will run magically in the background without any action from you.
What mngr does under the hood
mngr appends a JSON line per refresh to a standardized path (`events/<source>/usage/events.jsonl`) — each line contains a small `cost_snapshot` with a `session_id`, the rate-limit windows, and cost. `mngr usage` is a pure reader that aggregates over those files.
This is cool because it shows the usefulness of mngr’s abstraction over agents! In the future, you could manage your unused tokens across Claude, OpenAI, etc, all from one command line tool.
Donate your idle quota to science
Here's the part we're most excited about! We’re working on out of the box Claude skills in partnership with Dr. Sinnott-Armstrong from Fred Hutch Cancer Center, so mngr users can donate your about-to-expire capacity to genetics research with one command.
We're looking to sponsor other science/informatics research projects. If you're a researcher that could use the compute — reach out at [jean+doinggood@imbue.com]!