Tutu is a Z-shell bookmark manager. By integrating with tab completion, tutu makes it quick and easy to select any bookmarked directory and navigate to it.
Tutu provides three commands:
- tu - navigates to a bookmark using
cd
. - tutu - navigates to a bookmark using
pushd
- untu - wraps
popd
, sugar for returning after usingtutu
.
- Clone this repo
- Run these commands:
make install
source load_tutu
echo '[ -r "$HOME/.tutu/load_tutu" ] && source ~/.tutu/load_tutu' >> $HOME/.zshrc
Add targets by editing ~/.tutu/targets
. Each line in the file is composed of a bookmark name and a path.
It is important to keep a blank line at the end of the targets file.
Example:
my-bin ~/bin
proj ~/Documents/Projects
tutu ~/Documents/Projects/tutu
All tutu commands feature tab completion. You can access a list of matching targets by using tab completion.
To navigate to a directory, use the tu
command: tu <target name>
For example, based on the targets file above, tu my-bin
is equivalent to cd ~/bin
.
To navigate to a directory using the directory stack, use the tutu
command: tutu <target name>
.
For example, based on the targets file above, tu my-bin
is equivalent to push ~/bin
.
The untu
command is an alias for popd
. It is purely syntactic sugar and does not add any additonal capabilities.
While tutu
is entirely my own work, much of the project layout was mercilessly cribbed from what is used in the excellent smartcd
by Dave Olszewski. Any leftover cruft from my outright banditry is entirely on me.