retry-spinner

retry-spinner is a small CLI that re-runs a command until it succeeds or retries are exhausted.

Features:

• Retry up to N attempts (--retries, default: 10)
• Wait between attempts with a spinner (--wait, default: 2 seconds)
• Stream wrapped command stdout/stderr directly without buffering
• Per-attempt timeout with forced kill (--timeout, default: infinite)
• Forward command arguments after --

Installation

cargo install retry-spinner

Usage

retry-spinner [--retries <N>] [--wait <SECONDS>] [--timeout <SECONDS>] -- <command> [args...]

Examples:

retry-spinner -- curl -fsS https://example.com/health
retry-spinner --retries 20 --wait 1 --timeout 10 -- sh -c 'make test'

Exit behavior

• Exits 0 as soon as one attempt succeeds
• If all attempts fail, exits with the last attempt's exit code
• If timed out, that attempt counts as failure