How I Auto-Resume a Rate-Limited Claude Code Session with PROGRESS.md and Retries

Short summary

The author shares a 20-line shell script that automatically resumes Claude Code sessions when they hit rate limits. The approach uses a PROGRESS.md file as a handoff ticket — Claude updates it at each work boundary, and on restart it reads the file to resume from where it left off. The wrapper retries with configurable wait intervals and max attempts, sending desktop notifications on completion or failure.

• •PROGRESS.md acts as a context handoff ticket that Claude updates at each work boundary
• •A bash wrapper retries claude --continue on non-zero exit codes with configurable wait and max retries
• •Desktop notifications alert on completion, rate-limit detection, or max-retry exhaustion

Generated with AI, which can make mistakes.