How do I know if the script is working or just stuck?

The wrapper includes a visual countdown timer in the terminal and a debug mode (CLAUDE_LOOP_DEBUG=1) to view the raw JSON responses from Claude.

Does it preserve my session history when it retries?

Absolutely. The skill extracts the latest session ID and uses the --resume flag to ensure Claude picks up exactly where it left off.

What does the Claude Code Auto-Retry skill do?

It installs a 'claude-loop' command that wraps the Claude CLI to detect usage limits and automatically resumes your task after a specified cooldown period.

Can I customize the wait time between retries?

Yes, you can easily configure the retry interval using the CLAUDE_LOOP_DELAY environment variable, which defaults to 300 seconds.

Claude Code Auto-Retry Wrapper

Name: Claude Code Auto-Retry Wrapper
Author: baerae-zkap

bybaerae-zkap

0•

生产力与工作流

Automates Claude Code execution by handling usage limits and intelligently retrying sessions until completion.

The Claude Code Auto-Retry Wrapper provides a robust solution for developers facing interruptions due to Claude Code's usage quotas. By wrapping the standard CLI in a specialized bash script, it monitors output for rate-limit signatures, manages session resumes via JSON parsing, and implements a configurable countdown timer. This ensures that long-running tasks, such as massive refactors or complex feature builds, can proceed to completion without constant manual monitoring or task restarts.

主要功能

01Real-time countdown timer during wait periods

020 GitHub stars

03Automatic session resumption when hitting usage limits

04Configurable retry delays and maximum attempt counts

05Intelligent JSON parsing for accurate quota error detection

06Simple shell integration for Zsh and Bash users

使用场景

01Running autonomous background coding tasks that require periodic retries

02Executing large-scale codebase migrations that exceed single-session limits

03Managing Claude Code sessions in high-demand environments with strict rate limits

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add baerae-zkap/claude-loop-plugin install

For use in Claude.ai and ChatGPT

主要功能

01Real-time countdown timer during wait periods

020 GitHub stars

03Automatic session resumption when hitting usage limits

04Configurable retry delays and maximum attempt counts

05Intelligent JSON parsing for accurate quota error detection

06Simple shell integration for Zsh and Bash users

使用场景

01Running autonomous background coding tasks that require periodic retries

02Executing large-scale codebase migrations that exceed single-session limits

03Managing Claude Code sessions in high-demand environments with strict rate limits

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add baerae-zkap/claude-loop-plugin install

For use in Claude.ai and ChatGPT