rrrrrrrrrricoxi/cc-workflow-nudge — explained in plain English
Analysis updated 2026-05-18
Automatically resume a Claude Code task that got cut off by the 5-hour usage limit.
Avoid manually watching the clock and re-prompting Claude Code after a usage reset.
Run long Workflows overnight or unattended with confidence they will pick back up.
| rrrrrrrrrricoxi/cc-workflow-nudge | 123satyajeet123/bitnet-server | adeilsonrbrito/cross-model-consult | |
|---|---|---|---|
| Stars | 0 | 0 | 0 |
| Language | Shell | Shell | Shell |
| Setup difficulty | moderate | easy | moderate |
| Complexity | 3/5 | 2/5 | 3/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Needs jq and python3 installed, and works best once the status line capture step is configured for the exact reset time.
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.
A Claude Code plugin that auto-schedules a check right after the 5-hour usage reset so an interrupted long task resumes itself.
Mainly Shell. The stack also includes Shell, Node.js, Claude Code plugin.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.