Overview

fastdiract (fastdir + fastaction) is a pair of shell tools based on key-value storage for quick shell navigation and command execution.

Each tool saves directories/commands to one of 10 "memory" slots in a file for quick retrieval via 2-character aliases (d0-d9 and f0-f9).

Fastdir

fastdir is a shell navigation tool to help you store and jump to your most frequently used directories (aka fastdirs), stored in slots d0-d9.

For example, you can cd to a /deep/very/deep/directory and run d2. to save that location to slot d2. In the future, whenever you run d2, you will jump to that saved directory.

Here's fastdir cycling through 7 directories in about 4 seconds:

More commands:

• d/d? shows the list of fastdirs
• dw allows you to swap the position of two fastdirs
• dx changes the fastdir context
• dX creates a new fastdir context
• d- deletes a fastdir context
• dm shows the list of fastdirs and gives you a menu to run a command

Fastaction

fastaction is a tool to save frequently executed commands, stored in slots f0-f9. To save a command to slot f7, run something like f7. "echo hello there > myfile", making sure to wrap the command in double or single quotes. You can then execute the command easily by running f7.

More commands:

• f/f? shows the list of fastactions
• fw allows you to swap the position of two fastactions
• fx changes the fastaction context
• fX creates a new fastaction context
• f- deletes a fastaction context
• fm shows the list of fastactions and gives you a menu to run a command

Fastdiract Contexts

For situations where there are more than 10 items to save and remember, fastdiract supports the creation and management of "contexts", which can be switched between easily.

The following gif shows how fastdir contexts are switched and used (the same can be done for fastaction contexts).

Installation

To install fastdiract, run install.sh.

fzf must be installed to support fastdir/fastaction context switching, and python is needed to support setting fastactions.

Customization

fastdiract starts with some sane defaults, but it can be configured by changing the following options in the definitions file:

Configuration Variable	Description
FASTDIR_POSTCMD	Command to execute after jumping to a fastdir, e.g. ls
FASTDIR_ECHO	Whether to echo the fastdir command being executed, e.g. cd mydir
FASTACT_ECHO	Whether to echo the fastaction command being executed, e.g. echo 'hello there'
FASTACT_CONF	Whether to prompt for a y/n confirmation before executing a fastaction command
FASTACT_MENU_CONF	Whether to prompt for a y/n confirmation before executing a fastaction from the menu (fm)
FASTACT_D_RUNS_MENU	If set to "on", running d will run the fastdir menu (dm). Otherwise, d will just display the current fastdirs.
FASTACT_F_RUNS_MENU	If set to "on", running f will run the fastaction menu (fm). Otherwise, f will just display the current fastactions.
CTX_COLOR	Can be set to an ANSI color code for highlighting the context in different fastdiract commands. The default is green (\033[1;32m).

Misc

You can use fastaction commands recursively and use fastdir commands in fastaction commands, e.g. f1. = "d1 && f2 && echo hello"

Why would you want something like this when there are so many other directory navigation tools?

• Many tools like z or zoxide let you probabilistically switch to frequent or "frecent" directories, but when working with many directories with deep paths and similar names (e.g., /tree/deep/in/the/forest vs. tree/deep/in/the/dark/forest), there are no hard guarantees on where you'll end up. fastdiract, on the other hand, is fully deterministic since the user preselects the directory choices. Personally, I use bash aliases for directories I always use (e.g. alias fav="cd myfavdir), fastdiract for frequently used directories, and z for directories that I access infrequently.
• Some tools like bashmarks let you define a bookmark name and jump to it. However, remembering the names can get difficult and typing out long names takes time, whereas fastdiract lets you jump to any predefined directory with a 2-character combination, e.g., d1.

If you don't have fzf or would like to use a more stripped down version of fastdiract without contexts, check out the minimal branch.

Acknowledgements

The hand icon in the logo was created by nightwolfdezines and comes from Vecteezy.