aicioara / pick-dir

:point_up_2: An User-Experience-focused visual alternative to `cd`, aimed at achieving faster folder navigtion.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Pick Dir

An User-Experience-focused visual alternative to cd, aimed at achieving faster folder navigation.

Installation

Dependencies:

npm install -g pick-dir # May need to be prefixed by sudo

Setup

The recommended way of using pick-dir is by adding the following to your ~/.bashrc

d() {
  cd $( pick-dir )
}

Then source bashrc (source ~/.bashrc) and invoke using d

Usage

  • Once started, pick-dir will print to stderr the current list of files and folders.
  • Navigate around using arrow keys.
  • Quickly select a folder by typing part of its name.
  • Enter folders using Enter. Exit folders using Backspace.
  • Once finished press CTRL + C and the current folder will be printed to stdout. Ideally this will be served as an argument to cd

Keymap

  • PageUp / PageDown - Scroll up / down
  • ArrowUp / ArrowDown - Navigate through selection
  • Backspace - Move up one folder
  • Enter - Move inside selected folder
  • CTRL + C - Finish and print current folder to stdout
  • CTRL + W - Clear search

About

:point_up_2: An User-Experience-focused visual alternative to `cd`, aimed at achieving faster folder navigtion.

License:MIT License


Languages

Language:JavaScript 97.7%Language:Shell 2.3%