pathmaster
A powerful command-line tool for managing your system’s PATH environment variable, providing safe and efficient PATH manipulation with automatic backups and validation.
Version: 0.2.9
Features
- Safe PATH manipulation
- Smart shell configuration management
- Comprehensive validation and error checking
- Basic error prevention
Upcoming Features
- Enhanced backup system with multiple formats (JSON/TOML/plain text)
- User-defined backup locations
- Format conversion utilities
- Flexible backup modes for different needs
- Complete shell configuration management
See our Roadmap for more details.
Quick Start
Installation
cargo install pathmaster
Man Page Installation
After installing with Cargo, you can install the man page with:
pathmaster-install-man $HOME/.local
Or build from source:
git clone https://github.com/jwliles/pathmaster.git
cd pathmaster
cargo build --release
Basic Usage
# Add a directory to PATH
pathmaster add ~/bin
# List current PATH entries
pathmaster list
# Remove invalid entries
pathmaster flush
# Show backup history
pathmaster history
Documentation
- User Documentation: https://pathmaster.readthedocs.io/
- API Documentation: https://docs.rs/pathmaster
- Man Page:
man pathmaster - Command Help:
pathmaster --help
Contributing
Contributions are welcome! Please read our Contributing Guide for details on:
- Code of Conduct
- Development process
- Bug reports
- Feature requests
- Pull requests
License
This project is licensed under the MIT License - see the LICENSE file for details.