0xtadash1 / dirstax

Provides practical directory navigation, such as browser history

dirstax

Provides simple and practical directory navigation, such as browser history, using the built-in $dirstack feature of Zsh.

• shift+alt+← to go backwads to the previous directory
• shift+alt+→ to go forwards in the directory history
• shift+alt+↑ to go upwards to the parent directory

Tip

In macOS, ⌥ option is assigned instead of alt.

Note

Designed to utilize Zsh’s built-in $dirstack, this plugin turns on AUTO_PUSHD internally. (This Zsh option is off by default)

Enabling this option should have no impact unless using $dirstack-dependent plugins or features.

Usage

dirstax works out of the box. The default key bindings are activated immediately after the script is sourced.

Installation

git clone https://github.com/0xTadash1/dirstax, and Edit .zshrc:

source path/to/dirstax.plugin.zsh

with zinit

Install with Zsh plugin manager zinit:

zinit wait lucid light-mode for @0xTadash1/dirstax

Settings

The key bindings of dirstax can be changed as follows.

Please note that the environment variables should be set before loading dirstax.plugin.zsh.

# Use alt (or ⌥ option in macOS) as the modifier key instead of alt+shift
typeset -Ax dirstax
dirstax[keybind_upward]='^[[1;3A'    # alt + ↑
dirstax[keybind_forward]='^[[1;3C'   # alt + →
dirstax[keybind_backward]='^[[1;3D'  # alt + ←

License

MIT