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.
- POSIX: support for non-Cygwin Windows environments (e.g. Busybox).
- Bash/Fish/POSIX/Zsh: resolve symlinks on Windows.
0.9.9 - 2026-01-31
- Support for Android ARMv7.
- Fish: support for v4.1.0+.
- Nushell: use sigil operator when calling external commands.
- Zsh: support multiple digits in
z +Nandz -Ndirstack commands. - Bash: avoid downcasting
$PROMPT_COMMANDarray into a string. - Bash: avoid overwriting
$PIPESTATUS. - POSIX: remove non-POSIX compliant calls to
builtin. - Fish: clear existing completions when defining
zcommand.
0.9.8 - 2025-05-27
- Support for Tcsh.
- Added
--scoreflag tozoxide add. - POSIX: add doctor to diagnose common issues.
- Nushell: add CLI completions.
- Bash: zoxide will now automatically
cdwhen selecting Space-Tab completions.
- Bash: doctor now handles
$PROMPT_COMMANDbeing an array. - Bash: doctor now handles Visual Studio Code's shell integration.
- Bash: completions now work with
ble.sh. - Nushell: stop ignoring symlinks when
cd-ing into a directory. - Fzf: updated minimum supported version to v0.51.0.
- PowerShell: avoid setting
$errorwhen defining__zoxide_hooked. - PowerShell: handle special characters in file paths when
cd-ing into them. - Database corruption issue when the filesystem is 100% full.
0.9.7 - 2025-02-10
- Nushell: support for v0.102.0.
- Bash / Zsh: add doctor to diagnose common issues.
- ksh: alias to regular POSIX implementation for better compatibility.
0.9.6 - 2024-09-19
- Fish:
builtin abbrdoesn't work on older versions. - Zsh: make
__zoxide_z_completeavailable with--no-cmd.
0.9.5 - 2024-09-13
- Zsh: improved
cdcompletions. - 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 -- dirstyle queries. - Fish: improved Space-Tab completions.
- Ksh: added support for the Korn shell.
- fzf: removed
--select-1from default options. The interactive selector will now open up even if there is only one match. - Enforce that
$_ZO_DATA_DIRis 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:
cdcommand 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
-aforzoxide query --all.
- PowerShell: use
globalscope for variables / functions.
0.9.1 - 2023-05-07
- Fish/Zsh: aliases on
__zoxide_zwill 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
cdcompletions when there is a space in the path. - Bash/Fish/Zsh: providing
zcompletions when the last argument starts withz!. - Bash/Fish/Zsh: attempting to
cdwhen the last argument isz!.
0.9.0 - 2023-01-08
editsubcommand 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
chpwdhooks. - 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 -isubcommand: useeditinstead.
0.8.3 - 2022-09-02
- Nushell: support for
z -. - Nushell: support for PWD hooks.
- Fish: change fuzzy completion prefix to
z!. - Zsh: allow
zto navigate dirstack via+nand-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-aliaseswith--no-cmd. - Elvish: upgrade minimum supported version to v0.18.0.
- Nushell: upgrade minimum supported version to v0.61.0.
- Bash/Zsh: rename
_zcompletion function to avoid conflicts with other shell plugins. - Fzf: added
--keep-rightoption by default, upgrade minimum supported version to v0.21.0. - Bash: only enable completions on 4.4+.
- Fzf: bypass
lsalias in preview window. - Retain ownership of database file.
zoxide query --interactiveshould not conflict with--score.
0.8.0 - 2021-12-25
- Zsh: completions for
zcommand.
- 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
zcommand.
- Fish: error erasing completions on older versions.
- PowerShell: enable
--cmd cdto replace thecdcommand.
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
zcommand.
- Nushell: upgrade minimum supported version to v0.36.0.
- Nushell: easier installation instructions.
- Elvish: unable to
zinto directories by path. - Elvish: don't show traceback when
zorzifails. - 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 addandzoxide removenow 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 -Vnot printing version.
0.7.1 - 2021-06-09
- Auto-generated shell completions.
zoxide query --allfor listing deleted directories.- Lazy deletion for removed directories that have not been accessed in > 90 days.
- Nushell: support for v0.32.0+.
- Nushell: avoid calling
__zoxide_hookon non-filesystem subshells. - Fish:
alias cd=znow works, but it must be done after callingzoxide init. - PowerShell: avoid calling
__zoxide_hookon non-filesystem providers. - Fish: avoid calling
__zoxide_hookin private mode.
0.7.0 - 2021-05-02
- Manpages for all subcommands.
- Default prompt for Nushell.
zoxide remove -inow accepts multiple selections.zoxide addno longer accepts zero parameters.$_ZO_EXCLUDE_DIRSnow defaults to"$HOME".- Binary releases now use
.zipon Windows,.tar.gzotherwise.
cd -on Fish shells.__zoxide_hookno longer changes value of$?within$PROMPT_COMMANDon Bash.
- GitHub install script.
- Release binaries built with
glibc, usemuslinstead.
0.6.0 - 2021-04-09
znow 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_DIRSnow supports globs.zoxide initnow defines__zoxide_z*functions that can be aliased as needed.- Support for the Xonsh shell.
zoxide importcan now import from Autojump.
zoxide init --no-aliasesno longer generateszorzi.
- 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_OPTSto specify custom options forfzfzoxide query --listto list all matcheszoxide query --scoreto show score along with result
- Increased default value of
$_ZO_MAXAGEto10000. - Symlinks are treated as separate directories by default, this can be changed
by setting
_ZO_RESOLVE_SYMLINKS=1.
- Help menus for
zandzri. zoxide remove -iis replaced withzri.
0.4.1 - 2020-05-25
- Support for PowerShell.
- Backward compatibility with
v0.2.xdatabases. - Support for paths with invalid UTF-8.
0.4.0 - 2020-05-03
- Interactive mode for removing entries (
zoxide remove -i). - Aliases for interactive
queryandremove(zqiandzrirespectively). - PWD hooks for POSIX shells.
zoxide removenow throws an error if there was no match in the database.- Interactive mode in
zoxideno longer errors out iffzfexits gracefully. - Canonicalize to regular paths instead of UNC paths on Windows.
zoxide initnow uses PWD hooks by default for better performance.$_ZO_ECHOnow only works when set to1.- Using the
--z-cmdflag now also renames the associated aliases. - The
--z-cmdflag has been renamed to--cmd. - The
--no-define-aliasesflag has been renamed to--no-aliases.
- Fish no longer
cds to the user's home when no match is found.
0.3.1 - 2020-04-03
- Version output displays
gitrevision information. --z-cmdflag forzoxide initto rename thezcommand to something else.
zoxide queryoutput 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.xdatabases. $_ZO_EXCLUDE_DIRSto 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.
migratesubcommand renamed toimport.
- Thread safety using unique tempfile names for each
zoxideinstance. - Incomprehensive "could not allocate" message on database corruption.
0.2.2 - 2020-03-20
- Incorrect exit codes in
zcommand on Fish.
- File locks on database.
0.2.1 - 2020-03-16
$_ZO_ECHOto echo match beforecding.- Minimal
rangerplugin. - PWD hook to only update the database when the current directory is changed.
- Support for Bash.
migratesubcommand to allow users to migrate fromz.
- Interactive queries causing other open shells to hang.
0.2.0 - 2020-03-11
initsubcommand to remove dependency on shell plugin managers.- Support for
z -command to go to previous directory. Cargo.lockfor more reproducible builds.- Support for the Fish shell.
_zoxide_precmdoverriding 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
f64values for rank instead ofi32.
- Multiple hooks being added upon initializing
zoxidemultiple times.
0.1.0 - 2020-03-05
- GitHub Actions pipeline to build and upload releases.
- Add support for Zsh.