ndpath is a command-line tool for managing and editing the PATH environment variables. It provides an interactive interface to view, add, remove, and reorder directories in your PATH.
ndpath is a Python port of the pathos tool, which is written in Go. As the maintainer of ndpath, my motivation for creating this port is that I don't have sufficient knowledge of Go to contribute to the upstream development of pathos. Therefore, ndpath is intended to be a hard fork rather than a soft fork, allowing for independent development and maintenance.
To install ndpath, you need to have Python installed on your system. You can install ndpath using pip:
pip install ndpath
To use ndpath, simply run the following command in your terminal:
ndpath
This will launch the interactive interface of ndpath that will allow you to view, add, remove, and reorder paths in your PATH. You should also source the .pathos.env
file in your shell configuration file (e.g., .bashrc
, .zshrc
, etc.) to load the modified PATH into your shell environment.
source ~/.pathos.env
ndpath provides the following features:
- View the current list of directories in your
PATH
- Add new directories to your
PATH
- Remove directories from your PATH
- Reorder directories in your PATH
- Save changes to your PATH permanently
ndpath supports the following keyboard shortcuts:
-
q
- Quit the program (you will be prompted to save changes) -
k
or↑
- Move the selection cursor up -
j
or↓
- Move the selection cursor down -
o
- Insert a new directory below the selected directory -
O
- Insert a new directory above the selected directory -
x
- Delete the selected directory -
X
- Delete all non-existent directories from your PATH -
D
- Deduplicate the list of directories in your PATH -
S
- Manually save changes to your PATH
ndpath stores the modified PATH in a file named .ndpath.env
in your home directory.
This file is loaded by ndpath on startup and is updated whenever you save changes to your PATH.
Contributions to ndpath are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request on the GitHub repository.
ndpath is released under the MIT License. See the LICENSE file for more information.
ndpath is inspired by and based on the pathos tool. Special thanks to the creators and contributors of pathos for their work.