wtf is rate-limit-handoff?

rate-limit-handoff is a Python command line tool for people who use multiple AI coding assistants like Claude Code, Codex, Grok, Antigravity, or Cursor, and who regularly run into usage limits with one of them mid-task. Instead of losing track of what you were doing when a tool becomes unavailable, this tool writes everything that matters, the decisions made so far, what was tried and rejected, and the exact next step, into a single living file called handoff.md before you switch away. It offers three ways to keep working through a rate limit. You can wait for the same model to become available again, with an optional command that runs automatically once your stated reset time arrives. You can hand off immediately to a different AI tool, continuing the same task in a new assistant right away. Or you can switch temporarily and schedule an automatic return to the original tool later, so the switch is not permanent. Setting it up runs an init command that creates the handoff.md file and a small set of folders holding reusable instructions, called skills, that you can paste into whichever AI tool you use so it knows to offer these three options itself when it senses you are running low on capacity. It can also parse a pasted status message from tools like Codex to extract how much usage percentage remains and when it resets. The tool only ever runs the exact command you explicitly give it, splitting that command into its parts rather than passing it to a shell, and any scheduled resume it sets up runs locally as a best effort background job, not a guaranteed service that survives a reboot. It does not check any AI provider's servers to confirm capacity has actually returned, it relies on the time you told it. The project has no required external libraries beyond Python's own standard library and is released under the MIT license.