README.md

ff

ff is a command-line tool to manage favorite folders, creating an alias, to be used via shell directly with the cd command.

• Features
• Installation
  • Prebuilt binary
  • Update
• Usage
• Todo

Features

• Quickly create the alias of the folder you are in.
• Manage many aliases (tested with 200+ aliases)
• In case of conflict between an alias and a directory present, gives priority to the second.
• Once you have created the alias you do not have to close the terminal to be able to use it immediately.

Installation

Prebuilt binary

Download the prebuilt binary from here (stable) or here (all with pre-release) and run the following command:

tar -xf <prebuilt_archive> ff && sudo mv ff /usr/local/bin

Next add the following line to ~/.zshrc or ~/.bashrc:

source "$(ff alias)"

Update

To update the installed version of ff to the latest stable version, run the following command:

ff self-update

Usage

ff is a command-line tool to manage favorite folders, creating an alias,
to be used via shell directly with the cd command.

Usage:
  ff [command]

Examples:
$ ff add alias_name
$ ff add alias2 /tmp
$ ff update alias_name /var

Available Commands:
  add         Create a directory alias
  alias       Prints out the path to the alias file
  delete      Interactively allows you to delete an alias
  get         Return the raw path of an alias
  help        Help about any command
  list        List saved aliases
  panic       WARINING!! This delete all saved data
  self-update Update ff to the latest version
  update      Update a directory alias

Flags:
  -h, --help      help for ff
  -v, --version   version for ff

Use "ff [command] --help" for more information about a command.

TODO

• clean up the code
• make a better readme
• windows support
• ......