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.
dirstax works out of the box. The default key bindings are activated immediately after the script is sourced.
git clone https://github.com/0xTadash1/dirstax
, and Edit .zshrc
:
source path/to/dirstax.plugin.zsh
Install with Zsh plugin manager zinit:
zinit wait lucid light-mode for @0xTadash1/dirstax
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 + ←