I spend a fair amount of time wandering around in the terminal. The chances are that you are too since you dared to open this story. My daily activities led me to contribute to various kinds of projects (professional, personal and open-source). For my sanity, I tend to follow strict rules to organize my workspace, which helps me keep things tidied up and easily reachable. Or so I thought.
I decided to arrange my projects by following the
Go philosophy: make the
arborescence mirrors the urls where they are reachable. e.g.,
~/Workspace/src/github.com/aymericbeaumet/dotfiles would contain the project
dotfiles owned by
@aymericbeaumet and accessible at
github.com. That’s great, but I am now facing a complex
directory structure tedious to navigate quickly. Making it, in the end, harder
to access the resources I need.
$ pwd
/Users/aymericbeaumet/Workspace/src/github.com/brigad/back-endNobody wants to manually deal with this.
Remembering and typing the location of each project (even while leveraging autocomplete) is time-consuming. Creating shell aliases is not scalable. Instead, I would like to rely on the pseudo-unicity of each project name to find it among all the directories on my computer.
z?
Several tools exist to tackle this problem. My favorite is z. It follows the Unix philosophy by being small, focused and interoperable. z allows jumping around swiftly, automatically learning from your habits. The entries are ranked based on the frecency at which you access the directories.
Let’s walk through the basics of this tool. Below is how I advise to install it for Zsh on macOS (the install process should be similar for other shells and operating systems):
$ brew install z
$ echo "source '$(brew --prefix z)/etc/profile.d/z.sh'" >> ~/.zshenvInstall z for Zsh on macOS.
Note how installing z is not enough to start using it. You have to source
z.sh at the beginning of each shell session to activate it. The ~/.zshenv
configuration file is appropriate as Zsh
loads it in most circumstances,
making the tool accessible in a wide-variety of contexts (terminals, editors,
IDEs, scripts, etc.).
Let’s play
Once the install and setup are complete: start a new shell session, cd through
some folders and execute z to confirm it has been accurately tracking your
activity:
$ z | sort -rn | head -3
5331.72 /Users/aymericbeaumet/Workspace/src/github.com/brigad/back-end
637.255 /Users/aymericbeaumet/Workspace/src/github.com/brigad/ops
386.198 /Users/aymericbeaumet/.config/dotfilesTop 3 directories based on frecency.
As shown above, I spend quite some time navigating through Brigad projects, but it seems I also often access my dotfiles to tweak some configuration. The ranking score is volatile, and one could observe significant changes in a brief amount of time.
Now that z has accumulated some knowledge try it by navigating to one of the
tracked folders. Navigating is as simple as executing the z command followed
by the directory name:
$ z dotfiles
$ pwd
/Users/aymericbeaumet/.config/dotfilesNavigating by matching with a whole directory name.
As a matter of facts, I do prefer to leverage partial matching (imagine **
surrounding your search pattern) to type fewer characters. Hence, z dot is
valid and should produce a similar behavior as z dotfiles (modulo possible
name collisions, but you get the idea). This works because z relies on regular
expressions. For example, the snippet below will navigate to the directory
ending with the letters “tmp” (with the highest score):
$ z tmp$
$ pwd
/private/tmpNavigating by matching with a regular expression.
Neat right? I guess you start seeing the possibilities of this tool. And we have only scratched the surface of its capabilities. I suggest you dive in its documentation to get an idea of its full potential. Features such as autocomplete, subdirectories matching, consecutive matching, etc. are a game changer.
Conclusion
z is tremendous. This tool saves me a non-trivial amount of time every single day. When one starts relying on it, there is no going back. And I hope it’s going to fit your workflow as well as mine.
I would be grateful to hear any of your time-saving tricks. Feel free to share your experiences!