Unless you have reasons not to, you should probably use https://github.com/rupa/z/ - which is actually maintained, used, and lovingly cared for.
Spend a lot of time cd-ing around a complex directory tree?
j keeps track of where you’ve been and how much time you spend there, and provides a convenient way to jump to the directories you actually use. We use the term "frecency" to refer to how frequent and recent visits to a directory are.
This is a complete rethink of original j. See CHANGES for differences.
I've been using this for ease of experimentation, but prefer a pure shell version. for portability and ease of use.
put something like this in your .bashrc:
export JPY=/path/to/j.py # tells j.sh where the python script is . /path/to/j.sh # provides the j() function
cdaround for a while to build up the db
tested with python 2.6
if you are using python 2.5 you will need to add a line to
j.pyabove the import statement:
from __future__ import with_statement
python < 2.5 may require further alteration
jby itself (or
j -l) displays the current list of directories being remembered.
j foojumps to the highest weighted directory that has the substring
j foo barfor the weighted directory that has both
jsupports tab completion.
if you often prefer one of the non-default match type, use aliases:
alias jl='j -l' alias jt='j -t recent' alias jr='j -t rank'
Look for case sensitive match first, then fall back to case insensitive.
If all matches have a common prefix, and the prefix is one of the matches, and all args are matched in the prefix, go there unconditionally. This attempts to follow the principle of least surprise.
Frecency: alter rank by time of last access. * If access within last hour, multiply rank by 10. * If access within last day, multiply rank by 2. * If access within last week, divide rank by 2. * If access is more than a week, divide rank by 10.
I'm interested in improving/refining this algorithm, but it's a decent start.
Rank is recalculated as 0.9*rank when sum of ranks > 1000. When the rank of a directory falls below 1, it will fall off the list.
Q) How come
j doesn’t work like
j is not intended as a substitute for the cd command. You should still
cd everywhere as you normally would. When you want to jump somewhere you have been, then type
j <args> to jump to a directory in your often used list.
Q) How do i 'source' something? Why?
A) Short answer: instead of running the script as
j.sh you type
source j.sh or
. j.sh in a shell, or to make it available all the time, put a command in your
.bashrc that sources it, or just paste the contents of
j.sh directly into your
Long answer: sourcing is like importing. When you run a script in a shell, it creates a subshell, runs your script, and returns to your current shell. If you cd in that subshell, it won’t matter to your current shell, because when your script is done running, it exits, and comes back to where you (still) are in your current shell. What we want in this case is to have the function and commands in our script defined in our current shell. Sourcing – rather than executing – the file does exactly that.
Uses python to do the heavy lifting.
Uses 2 separate files, so install is a bit more complicated.
Default ordering is 'frecent': rank weighted by time since last access. Match by 'rank' and 'recent' still available.
If all matches have a common prefix, and the prefix is one of the matches, and all args are matched in the prefix, go there unconditionally. This attempts to follow the principle of least surprise and replaces the 'short' ordering.