Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
z is the new j, yo
Shell
branch: master

This branch is 1 commit ahead, 117 commits behind rupa:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
README.mkdn
z.1
z.sh

README.mkdn

User Commands

NAME

   z - jump around

SYNOPSIS

   z [-h] [-l] [-r] [-t] [regex1 regex2 ... regexn]

AVAILABILITY

   bash, zsh

DESCRIPTION

Tracks your most used directories, based on 'frecency'.After a short learning phase, z will take you to the most 'frecent' directory that matches ALL of the regexes given on the command line.

OPTIONS

   -h show a brief help message
   -l list only
   -r match by rank only
   -t match by recent access only

EXAMPLES

   z foo     cd to most frecent dir matching foo
   z foo bar cd to most frecent dir matching foo and bar
   z -r foo  cd to highest ranked dir matching foo
   z -t foo  cd to most recently accessed dir matching foo
   z -l foo  list all dirs matching foo (by frecency)

NOTES

Installation:

optionally: Set $_Z_CMD in .bashrc/.zshrc to change the command (default z).

Put something like this in your $HOME/.bashrc:

. /path/to/z.sh

Put something like this in your $HOME/.zshrc:

. /path/to/z.sh
function precmd () {
  _z --add "$(pwd -P)"
}

cd around for a while to build up the db.

PROFIT!!

"Frecency":

Frecency is a portmantaeu of 'recent' and 'frequency'. It is weighted rank that depends on how often and how recently something occured. As far as I know, Mozilla came up with the term. In z, a directory that has low ranking but has been accessed recently will quickly have higher rank than a directory accessed frequently a long time ago.

ENVIRONMENT

A function _z() is defined.

An alias $_Z_CMD='_z 2>&1' is defined. If not set, $_Z_CMD defaults to z.

FILES

Data is stored in $HOME/.z

SEE ALSO

   regex(7), cdargs, pushd, popd, autojump, cdargs

Please file bugs at https://github.com/rupa/z/

February 2011

Something went wrong with that request. Please try again.