Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fishgretel/fasd

Plugin for fish-shell to integrate fasd
https://github.com/fishgretel/fasd

Last synced: 5 days ago
JSON representation

Plugin for fish-shell to integrate fasd

Awesome Lists containing this project

README

        

# `fasd` (`fisher` plugin for `fish-shell`)

Plugin for [`fish-shell`](https://fishshell.com/) to integrate [`fasd`](https://github.com/clvv/fasd) into efficiency-seeking workflows:

> 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.

## Prerequisite

You will need [`fasd`](https://github.com/clvv/fasd). On macOS, install through [`homebrew`](https://brew.sh):

```fish
$ brew install fasd
```

## Install

With [`fisher`](https://github.com/jorgebucaran/fisher):

```fish
$ fisher install fishgretel/fasd
```

## Usage

Installing the plugin will enable the following functions (same as the `bash` aliases):

```bash
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
```

Let's try one out:

```
$ a fish
1.458 /Users/tom/.dotfiles/.config/fish/config.fish
2.349 /Users/tom/Sync/code/pycopy/bin/activate.fish
4.5339 /Users/tom/.config/fish/config.fish
4.66506 /Users/tom/.config/fish/functions/update.fish
4.6758 /Users/tom/Sync/prjcts/ExpressLRS/src/bin/activate.fish
12 /Users/tom/.config/fish
```

For more info, please check out the complete [fasd documentation][fasd].