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.

• Fish: builtin abbr doesn't work on older versions.
• Zsh: make __zoxide_z_complete available with --no-cmd.

• 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 aliasing cd=z.
• Symlinks not getting added to the database when $_ZO_RESOLVE_SYMLINKS=0.
• Symlinked database files getting replaced instead of the actual files.

• Zsh: improved Space-Tab completions.

• Nushell: support for v0.89.0.

• Short option -a for zoxide query --all.

• PowerShell: use global scope for variables / functions.

• 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 - and z +.
• 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 with z!.
• Bash/Fish/Zsh: attempting to cd when the last argument is z!.

• 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: use edit instead.

• 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.

• 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.

• 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.

• 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.

• Bash/Fish: improved completions for z command.

• Fish: error erasing completions on older versions.
• PowerShell: enable --cmd cd to replace the cd command.

• Auto-generated completions for Fig.

• Compile error with clap v3.0.0-beta.5.

• PowerShell: hook not initializing correctly.

• Nushell: upgrade minimum supported version to v0.37.0.

• Xonsh: error messages in zi.
• Xonsh: configuration environment variables not being handled correctly.

• 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 or zi fails.
• Elvish: nested shells do not initialize correctly.

• Compile error with clap v3.0.0-beta.4.

• zoxide add and zoxide 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.

• zoxide -V not printing version.

• 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 calling zoxide init.
• PowerShell: avoid calling __zoxide_hook on non-filesystem providers.
• Fish: avoid calling __zoxide_hook in private mode.

• 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, use musl instead.

• Support for Nushell.
• Support for Elvish.

• 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.

• $_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 generates z or zi.

• Clobber conflicting alias definitions in Bash/Fish/Zsh/POSIX shells.

• Deprecated PWD hooks for POSIX shells.
• Lazy deletion for inaccessible directories.

• Bug in Fish init script.

• $_ZO_FZF_OPTS to specify custom options for fzf
• zoxide query --list to list all matches
• zoxide query --score to show score along with result

• Increased default value of $_ZO_MAXAGE to 10000.
• Symlinks are treated as separate directories by default, this can be changed by setting _ZO_RESOLVE_SYMLINKS=1.

• Help menus for z and zri.
• zoxide remove -i is replaced with zri.

• Support for PowerShell.

• Backward compatibility with v0.2.x databases.
• Support for paths with invalid UTF-8.

• Interactive mode for removing entries (zoxide remove -i).
• Aliases for interactive query and remove (zqi and zri 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 if fzf 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 to 1.
• 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 cds to the user's home when no match is found.

• Version output displays git revision information.
• --z-cmd flag for zoxide init to rename the z command to something else.

• zoxide query output no longer has the query: prefix.

• Queries now also include checks for if the top level directory matches.

• 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 to import.

• Thread safety using unique tempfile names for each zoxide instance.
• Incomprehensive "could not allocate" message on database corruption.

• Incorrect exit codes in z command on Fish.

• File locks on database.

• $_ZO_ECHO to echo match before cding.
• 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 from z.

• Interactive queries causing other open shells to hang.

• 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.

• Install script for Linux/macOS users.
• Aging algorithm to remove stale entries.

• Database schema now uses f64 values for rank instead of i32.

• Multiple hooks being added upon initializing zoxide multiple times.

• GitHub Actions pipeline to build and upload releases.
• Add support for Zsh.