Claude Auto-Resume

Claude Auto-Resume is a powerful shell script utility designed to automatically manage Claude CLI tasks that may be interrupted due to usage limits. This tool enhances productivity by intelligently detecting when usage restrictions are lifted, waiting accordingly, and resuming task execution without manual intervention.

Use Cases

The script excels in various scenarios, particularly for developers using Claude Code:

• Task Interruption: Automatically resumes tasks that were halted when the Claude usage limit is reached.
• Seamless Continuation: By executing claude-auto-resume in any project directory, it continues previously unfinished tasks as soon as the usage limit allows.

Key Features

• 🔄 Automatic Detection: Identifies Claude CLI usage limits effortlessly.
• ⏰ Intelligent Waiting: Incorporates a countdown display to inform users of the remaining wait time.
• 🚀 Automatic Resumption: Restarts tasks automatically once usage limits are lifted.
• 🖥️ Cross-Platform Support: Compatible with both Linux and macOS environments.
• 📦 No External Dependencies: Relies solely on standard Unix tools, ensuring simplicity and efficiency.

How It Works

1. Limit Detection: The script executes claude -p 'check' to identify the status of the Claude CLI.
2. Output Parsing: It looks for specific messages indicating usage limits.
3. Wait Time Calculation: Determines the necessary wait time based on the output messages.
4. Countdown Display: Shows an ongoing countdown until tasks can resume.
5. Automatic Execution: Executes the required commands to resume tasks, either starting a new session or continuing a previous one.

Usage

Basic interactions with Claude Auto-Resume can be executed through simple commands:

# Start new session with default prompt
claude-auto-resume

# Start new session with a custom prompt
claude-auto-resume "implement user authentication"

# Show help
claude-auto-resume --help

Command Line Options

• No arguments: Initiates a new session with the standard prompt "continue".
• Custom prompt: Allows for custom prompts with a single argument.
• Flags: Use -p for a specific prompt or -c to continue a previous conversation.

Error Handling

The script incorporates comprehensive error handling, providing specific exit codes for various failure scenarios, ensuring robust operation.

Project Structure

claude-auto-resume/
├── claude-auto-resume.sh    # Main script file
├── Makefile                 # For installation tasks
├── docs/                    # Documentation folder
│   ├── architecture.md      # Technical architecture documentation
│   ├── prd.md               # Product requirements document
│   └── stories/             # User stories
├── CLAUDE.md                # Guide for Claude Code
└── README.md                # Project description

Conclusion

Claude Auto-Resume significantly enhances the efficiency of developers utilizing the Claude CLI by automating task resumption processes. It streamlines workflows and minimizes manual efforts, making it an essential tool for anyone integrating Claude into their development processes.