https://github.com/aicioara/pick-dir

:point_up_2: An User-Experience-focused visual alternative to `cd`, aimed at achieving faster folder navigtion.
https://github.com/aicioara/pick-dir

bash cd command-line navigation shell

Last synced: about 2 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/aicioara/pick-dir
• Owner: aicioara
• License: mit
• Created: 2018-05-17T16:19:31.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-06-04T17:49:23.000Z (over 6 years ago)
• Last Synced: 2024-04-24T15:23:53.882Z (9 months ago)
• Topics: bash, cd, command-line, navigation, shell
• Language: JavaScript
• Homepage:
• Size: 19.5 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Pick Dir

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

## Installation

Dependencies:

- [NodeJS](https://nodejs.org/en/)

- [NPM](https://www.npmjs.com/get-npm)

```bash

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`

```bash

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