Features

Usage

$ dir

Just run dir. You will be asked to select one of the bookmarked directories.

After picking a directory, your shell is cd to it thereafter.

It's a fast way one might change their working directory to another of the common directories they might use.

Driller

dir now has a driller feature. Use it by passing a directory as the first argument to dir. For example, to get a dir picker using your current working directory, run dir . The switcher will locate all the shallow subdirectories in the specified folder and present it to you.

Notes

Internally, dir uses pushd, which means you can use popd to get back to the folder you were in before (or cd -, for those keeping track).

Users should not call dirp directly. Doing so only reveals how the program works. If you check the output from dirp when invoked directly, you always see a file path of some kind after making a choice.

Future versions of dirp may add special behavior for direct invocation, but right now, there is simply no use for it. That is, always use dir, the shell function, as your entrypoint to the dirp software. See Design for more detail on the implementation being a function.