ezcd
is a cutting-edge tool designed to revolutionize the way users navigate directories in the command line. With this tool, you can navigate subdirectories using spaces instead of slashes, and employ path aliases to directly access desired directories from any location. This Rust-based tool integrates seamlessly with your existing shell environment, enhancing your productivity and simplifying directory navigation. Start enhancing your command line experience with ezcd
today.
-
Use space symbols instead of slash symbols in the original paths.
-
Jump from any working directory to an alias directory.
-
Auto-complete directory names.
-
Directory names are not case-sensitive.
Open your terminal, enter any directory where you want to install the project, and type:
git clone https://github.com/lilhammer111/ezcd.git
Enter the project root directory:
cd ezcd
Compile the project, which will generate an executable named ezcd-bin
in the ezcd/target/release
directory:
cargo build --release
Modify the permissions of install.sh
in the ezcd
project root directory and execute this script:
chmod +x install.sh && ./install.sh
If you see an output like this, everything is successfully completed:
...
💖 The cli tool 'ezcd' installed successfully.
💖 Please restart your terminal or source your '/home/<your-name>/.bashrc' to use ezcd.
Okay, let's open a new terminal and start experiencing ezcd
!
You can use --help
to view all currently available commands:
ezcd --help
The simplest usage of ezcd
is the same as cd
, except that it uses spaces instead of slash symbols.
For example, in the cd
command, if we want to enter a folder, the command might look like this:
cd Codes/RustProjects/ezcd
In ezcd
, the same command would look like this:
ezcd Codes RustProjects ezcd
A brief digression before we continue with the usage of ezcd: although replacing slashes with spaces in path representation might seem like a minor change, we cannot overlook the convenience of hitting the space bar on a keyboard compared to finding the slash key.
More importantly, this seemingly insignificant modification reflects a commitment to not giving up on excellence, even if the improvements are minor.
This philosophy is precisely why I started this project.Okay, let's get back to the usage.
ezcd
also has other very useful commands, for example, we can use ezcd
to set an alias for the current directory. Assuming that our current directory is at ~/Codes/RustProjects/ezcd
, then we can use --set
to set an alias for this directory:
ezcd --set ep
ep
is an abbreviation for the meaning of ezcd project, but you can replace it with any name you like. Let's use --list
to verify if the alias was set successfully:
ezcd --list
Furthermore, let's verify it practically by using the cd
command to enter the home directory, then using ezcd ep
to see if it switches the working directory correctly!
Well, that's about all the functionality ezcd
supports right now. Although it's simple, we hope to enhance the capabilities of this tool in future iterations.
Exciting news! I've added an auto-completion feature to ezcd
. Take a peek at the demo video below to see it in action.
Quick Tip: Simply hit the Tab
key for auto-completion—unlike the usual cd
command. Got more than one option? No problem! Just keep pressing Tab
to cycle through all available choices. Easy, right?