frencli 0.1.4

CLI frontend for fren - a fast, powerful command-line batch file renaming tool
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

# frencli Usage Example

## Complete Workflow: List → Transform → Rename → Undo

### Step 1: List Files

```bash
$ fren list "*.jpg" "*.txt"
Found 5 matching file(s):
  photo_003.jpg
  photo_002.jpg
  photo_001.jpg
  document_old_2.txt
  document_old.txt
```

### Step 2: Preview Transformation

```bash
$ fren list "*.jpg" "*.txt" transform "Vacation_%C3_%N.%E"
Old Name                                 -> New Name                                
------------------------------------------------------------------------------------
photo_003.jpg                            -> Vacation_001_photo_003.jpg              
photo_002.jpg                            -> Vacation_002_photo_002.jpg              
photo_001.jpg                            -> Vacation_003_photo_001.jpg              
document_old_2.txt                       -> Vacation_004_document_old_2.txt         
document_old.txt                         -> Vacation_005_document_old.txt           

Preview mode. Use 'rename' subcommand to perform the renaming.
```

### Step 3: Apply Rename

```bash
$ fren list "*.jpg" "*.txt" transform "Vacation_%C3_%N.%E" rename --yes
Old Name                                 -> New Name                                
------------------------------------------------------------------------------------
photo_003.jpg                            -> Vacation_001_photo_003.jpg              
photo_002.jpg                            -> Vacation_002_photo_002.jpg              
photo_001.jpg                            -> Vacation_003_photo_001.jpg              
document_old_2.txt                       -> Vacation_004_document_old_2.txt         
document_old.txt                         -> Vacation_005_document_old.txt           

Successfully renamed 5 file(s).
```

### Step 4: Verify Results

```bash
$ ls -1
Vacation_001_photo_003.jpg
Vacation_002_photo_002.jpg
Vacation_003_photo_001.jpg
Vacation_004_document_old_2.txt
Vacation_005_document_old.txt
```

### Step 5: Check Undo Availability

```bash
$ fren undo --check
Checking undo state for 5 renames from 2025-12-20 15:06:14...

5 file(s) can be safely undone.
```

### Step 6: Apply Undo

```bash
$ fren undo --apply --yes
Checking undo state for 5 renames from 2025-12-20 15:06:14...
Successfully reversed 5 renames.
```

### Step 7: Verify Undo

```bash
$ ls -1
document_old_2.txt
document_old.txt
photo_001.jpg
photo_002.jpg
photo_003.jpg
```