29 lines
900 B
Markdown
29 lines
900 B
Markdown
# Quickstart – Insert Command
|
||
|
||
1. **Preview an insertion at the start of filenames.**
|
||
```bash
|
||
renamer insert ^ "[2025] " --dry-run
|
||
```
|
||
- Shows the prepended tag without applying changes.
|
||
- Useful for tagging archival folders.
|
||
|
||
2. **Insert text near the end while preserving extensions.**
|
||
```bash
|
||
renamer insert 1$ "_FINAL" --path ./reports --dry-run
|
||
```
|
||
- `1$` places the string before the last character of the stem.
|
||
- Combine with `--extensions` to limit to specific file types.
|
||
|
||
3. **Commit changes once preview looks correct.**
|
||
```bash
|
||
renamer insert 3 "_QA" --yes --path ./builds
|
||
```
|
||
- `--yes` auto-confirms using the last preview.
|
||
- Ledger entry records the position token and inserted text.
|
||
|
||
4. **Undo the most recent insert batch if needed.**
|
||
```bash
|
||
renamer undo --path ./builds
|
||
```
|
||
- Restores original names using ledger metadata.
|