mirror of
https://github.com/skywind3000/z.lua
synced 2026-03-14 03:39:49 +00:00
c33f435df194f57f2e0ef17384aa804ad3d00b95
z.lua
z - jump around (lua implementation for running on both unix & windows)
Features
- 10x times faster than fasd and autojump
- 3x times faster than z.sh
- supports posix shells: bash, zsh, dash, sh, busybox, and etc.
- supports Windows cmd (with clink) and cmder
USE
z foo # cd to most frecent dir matching foo
z foo bar # cd to most frecent dir matching foo and bar
z -r foo # cd to highest ranked dir matching foo
z -t foo # cd to most recently accessed dir matching foo
z -l foo # list matches instead of cd
z -c foo # restrict matches to subdirs of $PWD
z -e foo # echo the best match, don't cd
Install
-
bash:
put something like this in your
.bashrc:eval "$(lua /path/to/z.lua --init bash)" -
zsh:
put something like this in your
.zshrc:eval "$(lua /path/to/z.lua --init zsh)" -
posix shells:
put something like this in your
.profile:eval "$(lua /path/to/z.lua --init posix)" -
Windows (with clink):
- copy z.lua and z.cmd to clink's home directory
- Add clink's home to
%PATH%(z.cmd can be called anywhere) - Ensure that "lua" can be called in
%PATH%
-
Windows Cmder:
- copy z.lua and z.cmd to cmder/vendor
- Add cmder/vendor to %PATH%
- Ensure that "lua" can be called in %PATH%
Customize
- set $_ZL_CMD in .bashrc/.zshrc to change the command (default z).
- set $_ZL_DATA in .bashrc/.zshrc to change the datafile (default ~/.zlua).
- set $_ZL_NO_PROMPT_COMMAND if you're handling PROMPT_COMMAND yourself.
- set $_ZL_EXCLUDE_DIRS to an array of directories to exclude.
Credit
Licensed under MIT license.
Languages
Lua
90.9%
Python
4.1%
Shell
2.8%
Batchfile
2.2%