Emacs integration for the command-line productivity booster `fasd'
Emacs Lisp
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
LICENSE readme Aug 31, 2013
README.org remove grizzl dependency and use standard completing-read-function Dec 16, 2016
fasd.el remove package-requires Dec 16, 2016

README.org

emacs-fasd

An Emacs extension to integrate 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.

Prerequisites

Installation

quelpa

quelpa is at https://github.com/quelpa/quelpa

(quelpa '(fasd :repo "steckerhalter/emacs-fasd" :fetcher github))

Since the recipe is stored in melpa this also works:

(quelpa 'fasd)

Interactively: M-x quelpa fasd RET.

MELPA

You can install fasd.el using the packages on Melpa.

Make sure you have something like the following in your Emacs startup file (~/.emacs.d/init.el, or ~/.emacs):

(add-to-list 'package-archives
             '("melpa" . "http://melpa.milkbox.net/packages/"))

To make that take effect, either evaluate that elisp expression or restart Emacs.

Then use M-x package-list-packages, select fasd from the list by pressing i, then press x to execute the changes. At that point, the package will be installed.

El-Get

Example recipe for el-get:

(:name fasd
       :type github
       :url "https://github.com/steckerhalter/emacs-fasd"
       :depends (grizzl)
       :postinit (progn
                   (global-set-key (kbd "C-h C-/") 'fasd-find-file)
                   (global-fasd-mode 1)))

Usage

Add a shortcut key for fasd-find-file and enable the global-fasd-mode which makes sure that opening files or directories in Emacs updates the fasd database.

(global-set-key (kbd "C-h C-/") 'fasd-find-file)
(global-fasd-mode 1)

Calling fasd-find-file with a prefix argument of

  • C-u lists only directories
  • M-- lists only files

With no prefix it shows files and directories.

Options

Use the customize interface:

M-x customize-group RET fasd RET

Initial Prompt

Usually fasd will prompt for a initial query. To turn that off and get all results directly, set fasd-enable-initial-prompt to nil.

Completion Function

By default the standard completing-read-function will be used, which could be using helm or ido depending on what you are using. To use e.g. ido explicitly set it to ido-completing-read. Previously the default was grizzl-completing-read but the dependency on grizzl has been removed. If you still want to use grizzl, you need to install the package and set the completing-read-function accordingly.

Standard search

By default the fasd search parameter is -a which searches files and directories, you can customize this with the fasd-standard-search option.