What is cc-workflow-nudge?

This project is a plugin for Claude Code, the AI coding assistant tool, that solves a specific annoyance: Claude Code accounts have a five hour usage window, and if a long running task gets cut off partway through by hitting that limit, someone normally has to come back and manually tell it to continue once the window resets. This plugin schedules a one time reminder timed to fire shortly after the reset, so an interrupted task picks itself back up automatically in the same session, without anyone waiting around. The plugin has three working parts. A hook watches for the moment a large task, called a Workflow, is about to start, and asks the assistant to arm the fallback. A second piece wraps the existing status line display, the small bar Claude Code shows during a session, to quietly capture the exact time the usage window will reset and how much of it has been used, without changing what the status line looks like to the user. A third piece, a skill, reads that captured reset time, works out a local schedule for a couple of minutes after the reset, and arms a one shot check using Claude Code's own scheduling feature. When that scheduled check eventually fires, it does not blindly assume the quota is back. It re-checks the cached usage numbers first, and if the limit has not actually reset yet, it reschedules itself for another attempt rather than giving up. If a task finishes normally without ever hitting the limit, the plugin cancels the pending reminder so it never fires needlessly. The project explains that it reads reset time information directly from Claude Code's own documented status line data, avoiding the need for any login token or network calls, unlike some earlier tools that had to read account credentials to reach an unofficial usage tracking service. It is written mostly in shell scripts with a small JavaScript helper, and it is released under the MIT license.