This document is a WORK IN PROGRESS.
This is just a quick personal cheat sheet: treat its contents with caution!

`fasd`¶

fasd is a command line productivity booster. fasd offers quick access to files and directories for POSIX shells: it keeps track of files and directories you have accessed, so that you can quickly reference them in the command line.

Reference(s)

https://github.com/clvv/fasd.git

Avoid dotfile madness¶

Prior to installation, make sure you stay in control of your home directory.

Prerequisite(s)

XDG

See how to handle fasd related dotfiles.

Install¶

pacmanaptyumdnffrom source

# pacman -S fasd

# apt install fasd

# yum install fasd

# dnf install fasd

Install fasd from git source:

$ cd ~/apps/src-apps
$ git clone https://github.com/clvv/fasd.git
$ cd fasd
$ git checkout 1.0.1 # checkout to latest tag (1.0.1 at the time of writting)
# make install

Config¶

Configure fasd:

$ vi $HOME/.bashrc # or ${ZDOTDIR:-${HOME}}/.zshrc or wherever
    > ...
    > # fasd
    > eval "$(fasd --init auto)"
    >
    > 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
    >
    > alias v='f -e nvim'      # quick opening files with nvim
    > alias m='f -e mpv'       # quick opening files with mpv
    > alias o='a -e xdg-open'  # quick opening files with xdg-open

$ source $HOME/.bashrc # or ${ZDOTDIR:-${HOME}}/.zshrc or wherever

Use¶

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
$ v foo            # run nvim on the most frecent file matching foo
$ mpv `f bar`      # run mpv 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`
$ nvim `f rc lo`   # like 'nvim /etc/rc.local'
$ nvim `f rc conf` # like 'nvim /etc/rc.conf'
$ o eng paper      # like 'xdg-open /you/dont/remember/where/english_paper.pdf'
$ v def conf       # like 'nvim /some/awkward/path/to/type/default.conf'
$ j abc            # like 'cd /hell/of/an/awkward/path/to/get/to/abcdef'
$ m movie          # like 'mpv /whatever/whatever/whatever/awesome_movie.mp4'

If this cheat sheet has been useful to you, then please consider leaving a star here.

fasd¶

Table of contents¶

Avoid dotfile madness¶

Install¶

Config¶

Use¶

`fasd`¶