Claude Code Pro Limit? Hack It While You Sleep

A shell script utility that automatically resumes Claude CLI tasks when usage limits are lifted. It detects Claude usage restrictions, waits intelligently, and resumes task execution automatically.

This script is particularly useful when using Claude Code for development in the following scenarios:

1. Task Interrupted by Usage Limits: When your Claude Code shows Claude usage limit reached. but your task is not yet completely finished
2. Automatic Task Resumption: Simply run claude-auto-resume in your project's root directory, and when the usage limit is lifted, the script will automatically let Claude Code continue executing your previously unfinished task

• 🔄 Automatically detects Claude CLI usage limits
• ⏰ Smart waiting with countdown display
• 🚀 Automatic task resumption
• 🖥️ Cross-platform support (Linux/macOS)
• 📦 Zero external dependencies (only standard Unix tools required)

1. Detect Limits: Execute claude -p 'check' command
2. Parse Output: Look for Claude AI usage limit reached|<timestamp> format messages
3. Calculate Wait Time: Calculate required wait time based on timestamp
4. Display Countdown: Show real-time remaining wait time
5. Auto Resume: Automatically execute either:
   • claude --dangerously-skip-permissions -p "<custom-prompt>" (new session, default)
   • claude -c --dangerously-skip-permissions -p "<custom-prompt>" (continue conversation with -c flag)

• No arguments: Start new session with default prompt "continue"
• Single argument: Start new session with custom prompt (e.g., claude-auto-resume "implement feature")
• -p, --prompt: Specify custom prompt with flag (e.g., claude-auto-resume -p "write tests")
• -c, --continue: Continue previous conversation (adds -c flag to claude command)
• -h, --help: Show help message and usage examples

Uses claude without -c for fresh conversation:

Uses claude -c to continue the last conversation:

• Claude CLI: Must be installed and available in PATH
• Standard Unix Tools: grep, date, sleep, awk (usually pre-installed)

The script includes comprehensive error handling:

• Exit Code 1: Claude CLI execution failed
• Exit Code 2: Unable to extract valid resume timestamp
• Exit Code 4: Resume command execution failed

1. Fork this repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Create a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details

If you encounter issues or have suggestions:

1. Check existing Issues
2. Create a new Issue describing the problem
3. Or submit a Pull Request

Note: This tool depends on Claude CLI output format. If Claude CLI updates change the output format, the script may need to be updated.