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
3. Custom Command Execution: Execute any shell command after waiting for usage limits, useful for restarting services, running builds, or processing data

Features

• 🔄 Automatically detects Claude CLI usage limits
• ⏰ Smart waiting with countdown display
• 🚀 Automatic task resumption
• 🔧 Custom command execution after wait periods
• 🛡️ Security warnings with cancellation options
• 🔗 Support for complex commands (pipes, redirections, operators)
• 🧪 Built-in test mode for development and validation
• 🖥️ Cross-platform support (Linux/macOS/Windows PowerShell)
• 📦 Zero external dependencies (only standard Unix tools required)

Installation

Linux/macOS installation steps are identical to the original upstream repository and are kept unchanged below.

method 1: using wget (Recommended)

wget -qO- https://raw.githubusercontent.com/terryso/claude-auto-resume/refs/heads/develop/claude-auto-resume.sh  | sudo tee /usr/local/bin/claude-auto-resume >/dev/null && sudo chmod +x /usr/local/bin/claude-auto-resume

#...