Smarter, faster file navigation for zsh.

日本語

Hit Ctrl+T and browse files and directories with fzf — navigate into folders with arrow keys, jump home with ~, and insert clean paths into your command line. All without leaving zsh.

• Shift+← / Shift+→ — navigate directories interactively
• ~ key — jump to home directory instantly
• Multi-select — Tab to pick multiple files, insert all at once
• Paths under ~/ are inserted with ~ notation preserved
• Paths under current directory are inserted with ./ prefix
• Permission errors shown as pink inline warnings

• zsh
• fzf
• zoxide — fast directory jumping via z / zi

brew install ayumuwall/tap/zshift

Then add to your ~/.zshrc:

source $(brew --prefix)/share/zshift/zshift.zsh

Then reload your shell:

source ~/.zshrc

zinit light ayumuwall/zshift

[plugins.zshift]
github = "ayumuwall/zshift"

git clone https://github.com/ayumuwall/zshift.git ~/.zsh/zshift
echo 'source ~/.zsh/zshift/zshift.zsh' >> ~/.zshrc

Press Ctrl+T anywhere on the command line to browse the current directory:

  Documents/          # cyan = directory
  Downloads/
  ./README.md         # gray ./ = file
  ./setup.sh

  Shift+←→: navigate   ~: home   Enter: confirm

zshift initializes zoxide in zi (interactive) mode. Just type z to fuzzy-select from your recently visited directories.

• If you've already typed a partial path, Ctrl+T starts browsing from there:

  vim src/<Ctrl+T>   # opens src/ contents
  

• The original fzf Ctrl+T is remapped to Ctrl+G, so it's always available.

• macOS — fully supported
• Linux — requires stat adaptation (PRs welcome)

MIT