fasd

Fasd Fasd (pronounced similar to "fast") is a command-line productivity booster. Fasd offers quick access to files and directories for POSIX shells. It is inspired by tools like autojump, z and v. Fasd keeps track of files and directories you have accessed, so that you can quickly reference them in the command line. The name fasd comes from the default suggested aliases f(files), a(files/directories), s(show/search/select), d(directories). Fasd ranks files and directories by "frecency," that is, by both "frequency" and "recency." The term "frecency" was first coined by Mozilla and used in Firefox (link). Introduction If you use your shell to navigate and launch applications, fasd can help you do it more efficiently. With fasd, you can open files regardless of which directory you are in. Just with a few key strings, fasd can find a "frecent" file or directory and open it with command you specify. Below are some hypothetical situations, where you can type in the command on the left and fasd will "expand" your command into the right side. Pretty magic, huh? v def conf => vim /some/awkward/path/to/type/default.conf j abc => cd /hell/of/a/awkward/path/to/get/to/abcdef m movie => mplayer /whatever/whatever/whatever/awesome_movie.mp4 o eng paper => xdg-open /you/dont/remember/where/english_paper.pdf vim `f rc lo` => vim /etc/rc.local vim `f rc conf` => vim /etc/rc.conf Fasd comes with some useful aliases by default: alias a='fasd -a' # any alias s='fasd -si' # show / search / select alias d='fasd -d' # directory alias f='fasd -f' # file alias sd='fasd -sid' # interactive directory selection alias sf='fasd -sif' # interactive file selection alias z='fasd_cd -d' # cd, same functionality as j in autojump alias zz='fasd_cd -d -i' # cd with interactive selection Fasd will smartly detect when to display a list of files or just the best match. For instance, when you call fasd in a subshell with some search parameters, fasd will only return the best match. This enables you to do: mv update.html `d www` cp `f mov` . Install Fasd is available in various package managers. Please check the wiki page for an up-to-date list. You can also manually obtain a copy of fasd. Download fasd 1.0.1 from GitHub: zip, tar.gz. Fasd is a self-contained POSIX shell script that can be either sourced or executed. A Makefile is provided to install fasd and fasd.1 to desired places. System-wide install: make install Install to $HOME: PREFIX=$HOME make install Or alternatively you can just copy fasd to anywhere you like (preferably under some directory in $PATH). To get fasd working in a shell, some initialization code must be run. Put the line below in your shell rc. eval "$(fasd --init auto)" This will setup a command hook that executes on every command and advanced tab completion for zsh and bash. If you want more control over what gets into your shell environment, you can pass customized set of arguments to fasd --init. zsh-hook # define _fasd_preexec and add it to zsh preexec array zsh-ccomp # zsh command mode completion definitions zsh-ccomp-install # setup command mode completion for zsh zsh-wcomp # zsh word mode completion definitions zsh-wcomp-install # setup word mode completion for zsh bash-hook # add hook code to bash $PROMPT_COMMAND bash-ccomp # bash command mode completion definitions bash-ccomp-install # setup command mode completion for bash posix-alias # define aliases that applies to all posix shells posix-hook # setup $PS1 hook for shells that's posix compatible tcsh-alias # define aliases for tcsh tcsh-hook # setup tcsh precmd alias Example for a minimal zsh setup (no tab completion): eval "$(fasd --init posix-alias zsh-hook)" Note that this method will slightly increase your shell start-up time, since calling binaries has overhead. You can cache fasd init code if you want minimal overhead. Example code for bash (to be put into .bashrc): fasd_cache="$HOME/.fasd-init-bash" if [ "$(command -v fasd)" -nt "$fasd_cache" -o ! -s "$fasd_cache" ]; then fasd --init posix-alias bash-hook bash-ccomp bash-ccomp-install >| "$fasd_cache" fi source "$fasd_cache" unset fasd_cache Optionally, if you can also source fasd if you want fasd to be a shell function instead of an executable. You can tweak initialization code. For instance, if you want to use "c" instead of "z" to do directory jumping, you can use the alias below: alias c='fasd_cd -d' # `-d` option present for bash completion # function fasd_cd is defined in posix-alias After you first installed fasd, open some files (with any program) or cd around in your shell. Then try some examples below. Examples f foo # list frecent files matching foo a foo bar # list frecent files and directories matching foo and bar f js$ # list frecent files that ends in js f -e vim foo # run vim on the most frecent file matching foo mplayer `f bar` # run mplayer on the most frecent file matching bar z foo # cd into the most frecent directory matching foo open `sf pdf` # interactively select a file matching pdf and launch `open` You should add your own aliases to fully utilize the power of fasd. Here are some examples to get you started: alias v='f -e vim' # quick opening files with vim alias m='f -e mplayer' # quick opening files with mplayer alias o='a -e xdg-open' # quick opening files with xdg-open If you're using bash, you have to call _fasd_bash_hook_cmd_complete to make completion work. For instance: _fasd_bash_hook_cmd_complete v m j o You could select an entry in the list of matching files. Matching Fasd has three matching modes: default, case-insensitive, and fuzzy. For a given set of queries (the set of command-line arguments passed to fasd), a path is a match if and only if: Queries match the path in order. The last query