pathmaster 0.2.9

pathmaster is a powerful command-line tool written in Rust for managing your system's PATH environment variable.
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166

# Command Overview

## Directory Management Commands

### add

Add directories to PATH

```bash
pathmaster add <directory>...

Options:
  <directory>...    One or more directories to add

Examples:
  pathmaster add ~/bin
  pathmaster add ~/bin ~/scripts /usr/local/bin
```

### delete

Remove directories from PATH

```bash
pathmaster delete <directory>...

Options:
  <directory>...    One or more directories to remove

Aliases:
  remove            Alternative to delete command

Examples:
  pathmaster delete ~/old/bin
  pathmaster remove ~/deprecated/scripts
```

### list

Display current PATH entries

```bash
pathmaster list

Output Format:
  - One entry per line
  - Full path displayed
  - Invalid paths marked
```

## Validation Commands

### check

Validate PATH entries

```bash
pathmaster check

Checks:
  - Directory existence
  - Read permissions
  - Invalid characters
  - Duplicate entries
```

### flush

Remove invalid entries

```bash
pathmaster flush

Actions:
  1. Creates backup
  2. Identifies invalid paths
  3. Removes invalid entries
  4. Updates shell config
  5. Provides removal summary
```

## Backup Commands

### --backup-mode

Configure backup behavior

```bash
pathmaster --backup-mode <mode>

Modes:
  default    Back up both PATH and shell config
  path       Back up only PATH entries
  shell      Back up only shell config
  switch     Toggle between modes

Example:
  pathmaster --backup-mode path add ~/bin
```

### history

Show backup history

```bash
pathmaster history

Output:
  - Backup timestamps
  - Backup file locations
  - Backup types (PATH/shell/both)
```

### restore

Restore from backup

```bash
pathmaster restore [--timestamp <time>]

Options:
  --timestamp    Specific backup to restore (YYYYMMDDHHMMSS)

Examples:
  pathmaster restore
  pathmaster restore --timestamp 20240301120000
```

## Global Options

### --help

Display help information

```bash
pathmaster --help
pathmaster <command> --help
```

### --version

Show version information

```bash
pathmaster --version
```

## Command Return Values

All commands return:

- 0 for success
- 1 for general errors
- 2 for invalid arguments

## Command Combinations

Commands can be combined with backup modes:

```bash
# Add with PATH-only backup
pathmaster --backup-mode path add ~/bin

# Flush with shell-only backup
pathmaster --backup-mode shell flush
```