Claude Retrier — Development skill for Claude Code
Auto-resume Claude Code after a usage limit.
How to install Claude Retrier
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open a0s/claude-retrier and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Claude Retrier does
Auto-resume Claude Code after a usage limit. One shell script, no tmux, no daemon.
Alternatives in Development
- Claude Swap — Switch between multiple Claude Code accounts, with automatic rate-limit rotation, usage dashboard, and paralle 2k ★
- Claude Auto Resume — A shell script utility that automatically resumes Claude CLI tasks when usage limits are lifted 732 ★
- Memory Search — Search through Claude's persistent memories for specific content, patterns, or keywords 332 ★
README
claude-retrier
[](https://github.com/a0s/claude-retrier/actions/workflows/test.yml) [](LICENSE)
Keep a **Claude Code** or **codex** session going when it stops — for a usage limit, or for a server that refused the turn — and restart it before it runs out of context. `claude-retrier` wraps claude, `codex-retrier` wraps codex. One shell script, with no tmux and no daemon behind it.
brew install a0s/claude-retrier/claude-retrier
claude-retrier # instead of: claude
codex-retrier # instead of: codex
Install
Homebrew, on macOS and Linux:
brew install a0s/claude-retrier/claude-retrier
Or take the file. It is self contained and there is no build step:
curl -fsSLO https://raw.githubusercontent.com/a0s/claude-retrier/main/claude-retrier.sh
chmod +x claude-retrier.sh
ln -s claude-retrier.sh codex-retrier # optional: the codex name
Both names are installed whichever agents you have. `codex-retrier` is the same file with codex as its default, and on a machine without codex all it does is say so — which also means installing codex later needs nothing reinstalled.
Every version is also attached to a [release](https://github.com/a0s/claude-retrier/releases), with the notes for it in [CHANGELOG.md](CHANGELOG.md).
Uninstall is `brew uninstall claude-retrier`, or deleting the file. Nothing else was touched: no shell rc edits, no launch agents, no background process.
Needs `bash` and `python3` 3.9+ ([details](docs/how-it-works.md#requirements)).
Quick start
Run it wherever you would have run `claude` or `codex`:
claude-retrier
Related Skills
Resume Fleet
Auto-resume a fleet of Claude Code CLI sessions that hit the usage limit. A hands-off launchd daemon (recommen
Cloophole
Auto-resume your Claude Code work the moment your usage limit resets. A tiny Windows app that watches the limi
Auto Resume
Arm a local timer that types your next prompt into this terminal ~10 minutes after your rate limit resets. Arm
Claude Code API Watchdog
Auto-recover Claude Code sessions stuck on transient API errors. Outer-loop watchdog for unattended tmux Claud
Claude Autocontinue
One-file bash script that auto-types 'continue' into Claude Code tmux panes when rate limits reset
Resume Limited
Resume workers parked on a Claude plan usage limit whose reset horizon has passed.
Related Agents
Doey Platform Expert
Platform systems specialist — tmux IPC, bash 3.2 portability, macOS process lifecycle, race condition preventi
Adrian
Blocks until a tmux pane is done (pattern match, shell idle, or output idle). Use for any wait that takes more
Usage Reporter
Reads real Claude Code usage from ~/.claude/stats-cache.json. Reports daily/weekly token usage by model, cache