All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.9.5 - 2024-09-13
- zsh: improved
cd
completions. - Lazily delete excluded directories from the database.
- fish: detect infinite loop when using
alias cd=z
. - Installer: added flags for
--bin-dir
,--man-dir
,--arch
, and--sudo
. - Nushell: support for v0.94.0+.
- bash/fish/zsh: support for
z -- dir
style queries. - fish: improved Space-Tab completions.
- ksh: added support for the Korn shell.
- fzf: removed
--select-1
from default options. The interactive selector will now open up even if there is only one match. - Enforce that
$_ZO_DATA_DIR
is an absolute path.
- zsh: Space-Tab completion repeating output multiple times when matching single directory
- fish / Nushell / PowerShell: handle queries that look like args (e.g.
z -x
). - elvish:
z -
now works as expected. - fish: generated shell code avoids using aliased builtins.
- fish:
cd
command is now copied directly from$__fish_data_dir/functions/cd.fish
. This should minimize the chances of an infinite loop when aliasingcd=z
. - Symlinks not getting added to the database when
$_ZO_RESOLVE_SYMLINKS=0
. - Symlinked database files getting replaced instead of the actual files.
0.9.4 - 2024-02-21
- zsh: improved Space-Tab completions.
0.9.3 - 2024-02-13
- Nushell: support for v0.89.0.
0.9.2 - 2023-08-04
- Short option
-a
forzoxide query --all
.
- PowerShell: use
global
scope for variables / functions.
0.9.1 - 2023-05-07
- Fish/Zsh: aliases on
__zoxide_z
will now use completions. - Nushell: support for v0.78.0.
- Fish: plugin now works on older versions.
- PowerShell: warn when PowerShell version is too old for
z -
andz +
. - PowerShell: support for PWD hooks on all versions.
- Fish: not providing
cd
completions when there is a space in the path. - Bash/Fish/Zsh: providing
z
completions when the last argument starts withz!
. - Bash/Fish/Zsh: attempting to
cd
when the last argument isz!
.
0.9.0 - 2023-01-08
edit
subcommand to adjust the scores of entries.
- Zsh: completions clashing with
zsh-autocomplete
. - Fzf: 'invalid option' on macOS.
- PowerShell: handle UTF-8 encoding correctly.
- Zsh: don't hide output from
chpwd
hooks. - Nushell: upgrade minimum supported version to v0.73.0.
- Zsh: fix extra space in interactive completions when no match is found.
- Fzf: various improvements, upgrade minimum supported version to v0.33.0.
- Nushell: accidental redefinition of hooks when initialized twice.
remove -i
subcommand: useedit
instead.
0.8.3 - 2022-09-02
- Nushell: support for
z -
. - Nushell: support for PWD hooks.
- Fish: change fuzzy completion prefix to
z!
. - Zsh: allow
z
to navigate dirstack via+n
and-n
. - Fzf: improved preview window.
- Bash: double forward slash in completions.
0.8.2 - 2022-06-26
- Fzf: show preview window below results.
- Bash/Fish/POSIX/Zsh: paths on Cygwin.
- Fish: completions not working on certain systems.
- Bash: completions not escaping spaces correctly.
0.8.1 - 2021-04-23
- Manpages: moved to
man/man1/*.1
. - Replace
--no-aliases
with--no-cmd
. - Elvish: upgrade minimum supported version to v0.18.0.
- Nushell: upgrade minimum supported version to v0.61.0.
- Bash/Zsh: rename
_z
completion function to avoid conflicts with other shell plugins. - Fzf: added
--keep-right
option by default, upgrade minimum supported version to v0.21.0. - Bash: only enable completions on 4.4+.
- Fzf: bypass
ls
alias in preview window. - Retain ownership of database file.
zoxide query --interactive
should not conflict with--score
.
0.8.0 - 2021-12-25
- Zsh: completions for
z
command.
- Fzf: better default options.
- Fish: interactive completions are only triggered when the last argument is empty.
- PowerShell: installation instructions.
- PowerShell: use global scope for aliases.
- Zsh: fix errors with
set -eu
. - Fzf: handle early selection.
- PowerShell: correctly handle escape characters in paths.
- Parse error on Cygwin/MSYS due to CRLF line endings.
- Fzf: handle spaces correctly in preview window.
- Bash: avoid initializing completions on older versions.
- Fzf: avoid launching binary from current directory on Windows.
0.7.9 - 2021-11-02
- Bash/Fish: improved completions for
z
command.
- Fish: error erasing completions on older versions.
- PowerShell: enable
--cmd cd
to replace thecd
command.
0.7.8 - 2021-10-21
- Auto-generated completions for Fig.
- Compile error with
clap v3.0.0-beta.5
.
0.7.7 - 2021-10-15
- PowerShell: hook not initializing correctly.
0.7.6 - 2021-10-13
- Nushell: upgrade minimum supported version to v0.37.0.
- Xonsh: error messages in
zi
. - Xonsh: configuration environment variables not being handled correctly.
0.7.5 - 2021-09-09
- Bash/Elvish: completions for
z
command.
- Nushell: upgrade minimum supported version to v0.36.0.
- Nushell: easier installation instructions.
- Elvish: unable to
z
into directories by path. - Elvish: don't show traceback when
z
orzi
fails. - Elvish: nested shells do not initialize correctly.
0.7.4 - 2021-08-15
- Compile error with
clap v3.0.0-beta.4
.
0.7.3 - 2021-08-05
zoxide add
andzoxide remove
now accept multiple arguments.
- Nushell: errors on 0.33.0.
- PowerShell: errors when initializing in
StrictMode
. - Bash/POSIX: remove conflicting alias definitions when initializing.
- Bash: remove extra semicolon when setting
$PROMPT_COMMAND
. - Xonsh: use shell environment instead of
os.environ
.
0.7.2 - 2021-06-10
zoxide -V
not printing version.
0.7.1 - 2021-06-09
- Auto-generated shell completions.
zoxide query --all
for listing deleted directories.- Lazy deletion for removed directories that have not been accessed in > 90 days.
- Nushell: support for 0.32.0+.
- Nushell: avoid calling
__zoxide_hook
on non-filesystem subshells. - Fish:
alias cd=z
now works, but it must be done after callingzoxide init
. - PowerShell: avoid calling
__zoxide_hook
on non-filesystem providers. - Fish: avoid calling
__zoxide_hook
in private mode.
0.7.0 - 2021-05-02
- Manpages for all subcommands.
- Default prompt for Nushell.
zoxide remove -i
now accepts multiple selections.zoxide add
no longer accepts zero parameters.$_ZO_EXCLUDE_DIRS
now defaults to"$HOME"
.- Binary releases now use
.zip
on Windows,.tar.gz
otherwise.
cd -
on fish shells.__zoxide_hook
no longer changes value of$?
within$PROMPT_COMMAND
on bash.
- GitHub install script.
- Release binaries built with
glibc
, usemusl
instead.
0.6.0 - 2021-04-09
z
now excludes the current directory from search results.
- Removed backtraces on Rust nightly.
- Generated shell code avoids using aliased builtins.
- Handle broken pipe errors gracefully when writing to streams.
- NUL file appearing in working directory on Windows.
- Accidental redefinition of hooks when initialized twice on some shells.
- zoxide unable to find itself on Xonsh shells.
- Aliases:
za
,zq
,zqi
,zr
,zri
. These are trivial aliases that can easily be defined manually, and aren't very useful to most users.
0.5.0 - 2020-10-30
$_ZO_EXCLUDE_DIRS
now supports globs.zoxide init
now defines__zoxide_z*
functions that can be aliased as needed.- Support for the xonsh shell.
zoxide import
can now import from Autojump.
zoxide init --no-aliases
no longer generatesz
orzi
.
- Clobber conflicting alias definitions in bash/fish/zsh/POSIX shells.
- Deprecated PWD hooks for POSIX shells.
- Lazy deletion for inaccessible directories.
0.4.3 - 2020-07-04
- Bug in Fish init script
0.4.2 - 2020-07-03
$_ZO_FZF_OPTS
to specify custom options forfzf
zoxide query --list
to list all matcheszoxide query --score
to show score along with result
- Increased default value of
$_ZO_MAXAGE
to10000
. - Symlinks are treated as separate directories by default, this can be changed
by setting
_ZO_RESOLVE_SYMLINKS=1
.
- Help menus for
z
andzri
. zoxide remove -i
is replaced withzri
.
0.4.1 - 2020-05-25
- Support for powershell.
- Backward compatibility with
v0.2.x
databases. - Support for paths with invalid UTF-8.
0.4.0 - 2020-05-03
- Interactive mode for removing entries (
zoxide remove -i
). - Aliases for interactive
query
andremove
(zqi
andzri
respectively). - PWD hooks for POSIX shells.
zoxide remove
now throws an error if there was no match in the database.- Interactive mode in
zoxide
no longer errors out iffzf
exits gracefully. - Canonicalize to regular paths instead of UNC paths on Windows.
zoxide init
now uses PWD hooks by default for better performance.$_ZO_ECHO
now only works when set to1
.- Using the
--z-cmd
flag now also renames the associated aliases. - The
--z-cmd
flag has been renamed to--cmd
. - The
--no-define-aliases
flag has been renamed to--no-aliases
.
- fish no longer
cd
s to the user's home when no match is found.
0.3.1 - 2020-04-03
- Version output displays
git
revision information. --z-cmd
flag forzoxide init
to rename thez
command to something else.
zoxide query
output no longer has thequery:
prefix.
- Queries now also include checks for if the top level directory matches.
0.3.0 - 2020-03-30
- Automatic migration from
v0.2.x
databases. $_ZO_EXCLUDE_DIRS
to prevent directories from being added to the database.- Support for POSIX-compliant shells.
- Database location defaults to user's local data directory.
- Database schema now includes a version number.
migrate
subcommand renamed toimport
.
- Thread safety using unique tempfile names for each
zoxide
instance. - Incomprehensive "could not allocate" message on database corruption.
0.2.2 - 2020-03-20
- Incorrect exit codes in
z
command on fish.
- File locks on database.
0.2.1 - 2020-03-16
$_ZO_ECHO
to echo match beforecd
ing.- Minimal
ranger
plugin. - PWD hook to only update the database when the current directory is changed.
- Support for bash.
migrate
subcommand to allow users to migrate fromz
.
- Interactive queries causing other open shells to hang.
0.2.0 - 2020-03-11
init
subcommand to remove dependency on shell plugin managers.- Support for
z -
command to go to previous directory. Cargo.lock
for more reproducible builds.- Support for the fish shell.
_zoxide_precmd
overriding other precmd hooks on zsh.
0.1.1 - 2020-03-08
- Install script for Linux/macOS users.
- Aging algorithm to remove stale entries.
- Database schema now uses
f64
values for rank instead ofi32
.
- Multiple hooks being added upon initializing
zoxide
multiple times.
0.1.0 - 2020-03-05
- GitHub Actions pipeline to build and upload releases.
- Support for zsh.