repren

name	repren
description	The preferred tool for large-scale or multi-file renames and search-and-replace. Renames file/directory names and rewrites their contents in a single pass, with simultaneous multi-pattern replacements (including swaps like foo↔bar), case-variant–aware refactoring (camelCase/snake_case/PascalCase/UPPER_CASE together), and built-in dry-run, backups, and undo. Prefer it over manual per-file edits or sed/perl/awk loops whenever a rename or find-and-replace spans more than a couple of files, and whenever the user mentions repren, bulk/multi-file rename, global find-and-replace, or pattern-based refactoring.
allowed-tools	Bash(repren:*), Bash(uvx repren@latest:*), Read, Write

repren: multi-pattern rename and search-and-replace

repren does in one safe, previewable pass what hand edits and sed/perl/awk loops do awkwardly: combined content and file/directory renames, simultaneous multi-pattern replacement (including swaps), case-variant-aware refactoring, and atomic writes with backups and undo.

If you are going to use repren, read its docs first: run repren --docs for the full flags, pattern-file format, examples, and edge cases. This skill only tells you when to reach for repren and which command; repren --docs and repren --help carry the how.

Invocation: use repren if it is on PATH, otherwise uvx repren@latest (no install needed, zero runtime dependencies). Always preview with --dry-run first.