Quick Start Guide

Basic Operations

Adding Directories

# Add a single directory
pathmaster add ~/bin

# Add multiple directories
pathmaster add ~/bin ~/scripts /usr/local/bin

Viewing Current PATH

# List all PATH entries
pathmaster list

Removing Directories

# Remove a directory
pathmaster delete ~/old/bin

# Remove multiple directories
pathmaster delete ~/old/bin ~/deprecated/scripts

Path Validation

Check for Invalid Paths

# Validate current PATH
pathmaster check

Remove Invalid Paths

# Clean up invalid entries
pathmaster flush

Backup Management

Configuring Backup Mode

# Default (both PATH and shell)
pathmaster --backup-mode default

# PATH-only backup
pathmaster --backup-mode path

# Shell-only backup
pathmaster --backup-mode shell

# Toggle between modes
pathmaster --backup-mode switch

Managing Backups

# View backup history
pathmaster history

# Restore from latest backup
pathmaster restore

# Restore specific backup
pathmaster restore --timestamp 20240301120000

Common Workflows

Adding New Development Tools

  1. Create development bin directory:

mkdir -p ~/dev/bin

  1. Add to PATH:

pathmaster add ~/dev/bin

  1. Verify addition:

pathmaster list

Cleaning Up PATH

  1. Check for invalid entries:

pathmaster check

  1. Remove invalid entries:

pathmaster flush

  1. Verify changes:

pathmaster list

Backup and Restore

  1. Configure backup mode:

pathmaster --backup-mode default

  1. Make changes to PATH

  2. View backup history:

pathmaster history

  1. Restore if needed:

pathmaster restore

Next Steps