ad

Chdir with file-manager.

$ pwd
/path/to/directory

$ ad
/path/to/directory

dir1/
dir2/
file1.txt
file2.txt
(Up, up, up, move to another/, move to directory/, chdir and exit)

$ pwd
/another/directory

Usage

$ ad [<option(s)>]
chdir with file-manager.

options:
  -w, --wrapper=<shell>  output the wrapper script for the shell and exit
      --help             print usage and exit

supported-shells:
  sh, bash, zsh, yash, fish

environment-variables:
  AD_SHOW_HIDDEN_FILES  show hidden files if set to true (default: false)

keys:
  +       toggle show hidden files
  -       chdir to the parent directory in file-manager
  <CR>    chdir to the directory in file-manager
  <C-g>   quit file-manager and chdir to the last directory
  q       quit file-manager

Requirements

• Bash (Even if you are not using Bash)
• Vim

Installation

1. Copy ad into your $PATH.
2. Make ad executable.
3. Add the following config to your shell's profile.

Shell
sh	eval "$(ad -w sh)"
bash	eval "$(ad -w bash)"
zsh	eval "$(ad -w zsh)"
yash	eval "$(ad -w yash)"
fish	source (ad -w yash | psub)

Example

$ curl -L https://raw.githubusercontent.com/nil-two/ad/master/ad > ~/bin/ad
$ chmod +x ~/bin/ad
$ echo 'eval "$(ad -w bash)"' >> ~/.bashrc

Note: In this example, $HOME/bin must be included in $PATH.

Also, if you are using Bash, you can execute ad from a shortcut key by adding the following config to your .bashrc.

bind -x '"\C-g": ad'

Options

-w, --wrapper=<shell>

Output the wrapper script for the shell and exit. If you load the script, you will be able to chdir when you press <C-g> in file-manager.

Supported shells are as follows:

• sh
• bash
• zsh
• yash
• fish

$ eval "$(ad -w sh)"
(Enable the shell integration for the shell compatible with Bourne Shell)

$ eval "$(ad -w bash)"
(Enable the shell integration for Bash)

$ eval "$(ad -w zsh)"
(Enable the shell integration for Zsh)

$ eval "$(ad -w yash)"
(Enable the shell integration for Yash)

$ source (ad -w fish | psub)
(Enable the shell integration for Fish)

--help

Print usage and exit.

$ ad --help
(Print usage)

Variables

AD_SHOW_HIDDEN_FILES

Show hidden files from the start if set to true. The default value is false.

# Show hidden files from the beginning
export AD_SHOW_HIDDEN_FILES=true

License

MIT License

Author

nil2 nil2@nil2.org