# zoxide changelog

> A smarter cd command that learns your habits.

- Vendor: Ajeet D'Souza
- Category: Developer Tools
- Official site: https://github.com/ajeetdsouza/zoxide
- Tracked by: What's New (https://whatsnew.fyi/product/zoxide)
- Harvested from: GitHub (ajeetdsouza/zoxide)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### v0.10.0 — 0.10.0

- Date: 2026-07-04
- Version: v0.10.0
- Original notes: https://github.com/ajeetdsouza/zoxide/releases/tag/v0.10.0
- Permalink: https://whatsnew.fyi/product/zoxide/releases/v0.10.0

- **added** — import now supports fetching entries from atuin
- **added** — import now auto-detects database files
- **added** — import now skips directories matching $_ZO_EXCLUDE_DIRS
- **added** — Support for non-Cygwin Windows environments such as Busybox on POSIX
- **added** — Fish Space-Tab completions now display and run the selected command
- **added** — Bash/POSIX/Zsh z now honors $CDPATH
- **added** — Bash does not add to the database when history is disabled
- **added** — Nushell export commands so the init script can be imported with use
- **added** — Support for RISC-V riscv64 Linux
- **changed** — import now takes a subcommand instead of the --from flag
- **fixed** — Bash/POSIX/Zsh z now handles relative paths through symlinked directories
- **fixed** — Bash/Fish/POSIX/Zsh _ZO_RESOLVE_SYMLINKS now works on Windows
- **fixed** — Bash handles $PROMPT_COMMAND values ending in a semicolon
- **fixed** — PowerShell navigates to home directory with z on drives that do not define HOME
- **fixed** — PowerShell uses fully qualified names when invoking cmdlets
- **fixed** — Zsh skips doctor diagnostics in non-interactive shells
- **fixed** — Zsh avoids inserting a trailing space when cancelling interactive Space-Tab completions
- **fixed** — Bash avoids blanking the prompt when cancelling interactive Space-Tab completions
- **fixed** — Bash/Fish/Zsh avoid drawing a new line when Space-Tab completion finds no matches
- **fixed** — Tcsh preserves any existing precmd alias instead of overwriting it

###### Added

- `import` now supports fetching entries from `atuin`.
- `import` now auto-detects database files.
- `import` now skips directories matching `$_ZO_EXCLUDE_DIRS`.
- POSIX: support for non-Cygwin Windows environments (e.g. Busybox).
- Fish: Space-Tab completions now display and run the selected command.
- Bash/POSIX/Zsh: `z` now honors `$CDPATH`.
- Bash: don't add to the database when history is disabled (`set +o history`).
- Nushell: export commands so the init script can be imported with `use`.
- Support for RISC-V (riscv64) Linux.

###### Changed

- `import` now takes a subcommand instead of the `--from` flag.

###### Fixed

- Bash/POSIX/Zsh: `z` now handles relative paths through symlinked directories.
- Bash/Fish/POSIX/Zsh: `_ZO_RESOLVE_SYMLINKS` now works on Windows.
- Bash: handle `$PROMPT_COMMAND` values ending in a semicolon.
- PowerShell: navigate to home directory with `z` on drives that don't define `HOME`.
- PowerShell: use fully qualified names when invoking cmdlets.
- Zsh: skip doctor diagnostics in non-interactive shells.
- Zsh: avoid inserting a trailing space when cancelling interactive Space-Tab completions.
- Bash: avoid blanking the prompt when cancelling interactive Space-Tab completions.
- Bash/Fish/Zsh: avoid drawing a new line when Space-Tab completion finds no matches.
- Tcsh: preserve any existing `precmd` alias instead of overwriting it.
- Nushell: complete only directories for `z`, instead of all files.

### v0.9.9 — 0.9.9

- Date: 2026-01-31
- Version: v0.9.9
- Original notes: https://github.com/ajeetdsouza/zoxide/releases/tag/v0.9.9
- Permalink: https://whatsnew.fyi/product/zoxide/releases/v0.9.9

- **added** — Support for Android ARMv7
- **added** — Fish support for v4.1.0+
- **fixed** — Nushell uses sigil operator when calling external commands
- **fixed** — Zsh supports multiple digits in z +N and z -N dirstack commands
- **fixed** — Bash avoids downcasting $PROMPT_COMMAND array into a string
- **fixed** — Bash avoids overwriting $PIPESTATUS
- **fixed** — POSIX removes non-POSIX compliant calls to builtin
- **fixed** — Fish clears existing completions when defining z command

###### Added

- Support for Android ARMv7.
- Fish: support for v4.1.0+.

###### Fixed

- Nushell: use sigil operator when calling external commands.
- Zsh: support multiple digits in `z +N` and `z -N` dirstack commands.
- Bash: avoid downcasting `$PROMPT_COMMAND` array into a string.
- Bash: avoid overwriting `$PIPESTATUS`.
- POSIX: remove non-POSIX compliant calls to `builtin`.
- Fish: clear existing completions when defining `z` command.

### v0.9.8 — 0.9.8

- Date: 2025-05-26
- Version: v0.9.8
- Original notes: https://github.com/ajeetdsouza/zoxide/releases/tag/v0.9.8
- Permalink: https://whatsnew.fyi/product/zoxide/releases/v0.9.8

- **added** — Support for Tcsh
- **added** — Added --score flag to zoxide add
- **added** — POSIX: add doctor to diagnose common issues
- **added** — Nushell: add CLI completions
- **changed** — Bash: zoxide will now automatically cd when selecting Space-Tab completions
- **fixed** — Bash: doctor now handles PROMPT_COMMAND being an array
- **fixed** — Bash: doctor now handles Visual Studio Code's shell integration
- **fixed** — Bash: completions now work with ble.sh
- **fixed** — Nushell: stop ignoring symlinks when cd-ing into a directory
- **fixed** — Fzf: updated minimum supported version to v0.51.0
- **fixed** — PowerShell: avoid setting $error when defining __zoxide_hooked
- **fixed** — PowerShell: handle special characters in file paths when cd-ing into them
- **fixed** — Database corruption issue when the filesystem is 100% full

###### Added

- Support for Tcsh.
- Added `--score` flag to `zoxide add`.
- POSIX: add doctor to diagnose common issues.
- Nushell: add CLI completions.

###### Changed

- Bash: zoxide will now automatically `cd` when selecting Space-Tab completions.

###### Fixed

- Bash: doctor now handles `PROMPT_COMMAND` being 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 `$error` when defining `__zoxide_hooked`.
- PowerShell: handle special characters in file paths when `cd`-ing into them.
- Database corruption issue when the filesystem is 100% full.

### v0.9.7 — 0.9.7

- Date: 2025-02-09
- Version: v0.9.7
- Original notes: https://github.com/ajeetdsouza/zoxide/releases/tag/v0.9.7
- Permalink: https://whatsnew.fyi/product/zoxide/releases/v0.9.7

- **added** — Nushell support for version 0.102.0
- **added** — Bash and Zsh doctor command to diagnose common issues
- **fixed** — ksh alias changed to regular POSIX implementation for better compatibility

###### Added

- Nushell: support for 0.102.0.
- Bash / Zsh: add doctor to diagnose common issues.

###### Fixed

- ksh: alias to regular POSIX implementation for better compatibility.

### v0.9.6 — 0.9.6

- Date: 2024-09-19
- Version: v0.9.6
- Original notes: https://github.com/ajeetdsouza/zoxide/releases/tag/v0.9.6
- Permalink: https://whatsnew.fyi/product/zoxide/releases/v0.9.6

- **fixed** — Fish: builtin abbr doesn't work on older versions
- **fixed** — Zsh: make __zoxide_z_complete available with --no-cmd

###### Fixed

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

### v0.9.5 — 0.9.5

- Date: 2024-09-13
- Version: v0.9.5
- Original notes: https://github.com/ajeetdsouza/zoxide/releases/tag/v0.9.5
- Permalink: https://whatsnew.fyi/product/zoxide/releases/v0.9.5

- **added** — Zsh improved cd completions
- **added** — Lazily delete excluded directories from the database
- **added** — Fish detect infinite loop when using alias cd=z
- **added** — Installer added flags for --bin-dir, --man-dir, --arch, and --sudo
- **added** — Nushell support for v0.94.0+
- **added** — Bash, fish, and zsh support for z -- dir style queries
- **added** — Fish improved Space-Tab completions
- **added** — Korn shell support
- **changed** — Fzf removed --select-1 from default options
- **changed** — Enforce that $_ZO_DATA_DIR is an absolute path
- **fixed** — Zsh Space-Tab completion repeating output multiple times when matching single directory
- **fixed** — Fish, Nushell, and PowerShell handle queries that look like args (e.g. z -x)
- **fixed** — Elvish z - now works as expected
- **fixed** — Fish generated shell code avoids using aliased builtins
- **fixed** — Fish cd command is now copied directly from $__fish_data_dir/functions/cd.fish
- **fixed** — Symlinks not getting added to the database when $_ZO_RESOLVE_SYMLINKS=0
- **fixed** — Symlinked database files getting replaced instead of the actual files

###### Added

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

###### Changed

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

###### Fixed

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

### v0.9.4 — 0.9.4

- Date: 2024-02-20
- Version: v0.9.4
- Original notes: https://github.com/ajeetdsouza/zoxide/releases/tag/v0.9.4
- Permalink: https://whatsnew.fyi/product/zoxide/releases/v0.9.4

###### Changed

- zsh: improved Space-Tab completions.

### v0.9.3 — 0.9.3

- Date: 2024-02-12
- Version: v0.9.3
- Original notes: https://github.com/ajeetdsouza/zoxide/releases/tag/v0.9.3
- Permalink: https://whatsnew.fyi/product/zoxide/releases/v0.9.3

###### Added

- Nushell: support for v0.89.0.

### v0.9.2 — 0.9.2

- Date: 2023-08-04
- Version: v0.9.2
- Original notes: https://github.com/ajeetdsouza/zoxide/releases/tag/v0.9.2
- Permalink: https://whatsnew.fyi/product/zoxide/releases/v0.9.2

- **added** — Short option -a for zoxide query --all
- **fixed** — PowerShell: use global scope for variables / functions

###### Added

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

###### Fixed

- PowerShell: use `global` scope for variables / functions.

### v0.9.1 — 0.9.1

- Date: 2023-05-07
- Version: v0.9.1
- Original notes: https://github.com/ajeetdsouza/zoxide/releases/tag/v0.9.1
- Permalink: https://whatsnew.fyi/product/zoxide/releases/v0.9.1

- **added** — Fish/Zsh aliases on __zoxide_z will now use completions
- **added** — Nushell add support for v0.78.0
- **added** — Fish plugin now works on older versions
- **added** — PowerShell warn when PowerShell version is too old for z - and z +
- **added** — PowerShell support for PWD hooks on all versions
- **fixed** — Fish not providing cd completions when there is a space in the path
- **fixed** — Bash/Fish/Zsh providing z completions when the last argument starts with z!
- **fixed** — Bash/Fish/Zsh attempting to cd when the last argument is z!

###### Added

- Fish/Zsh: aliases on `__zoxide_z` will now use completions.
- Nushell: add 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.

###### Fixed

- 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!`.