zoxide

Developer Tools

A smarter cd command that learns your habits.

Latest v0.10.0 · by Ajeet D'SouzaWebsiteajeetdsouza/zoxide

Release activity

Release activity — 2 releases across 2 days in the last year. Each cell is one day; darker means more releases that day. Older weeks are hidden at this screen width.
MayJunJulAug
SundayNo releases on Apr 26, 2026No releases on May 3, 2026No releases on May 10, 2026No releases on May 17, 2026No releases on May 24, 2026No releases on May 31, 2026No releases on Jun 7, 2026No releases on Jun 14, 2026No releases on Jun 21, 2026No releases on Jun 28, 2026No releases on Jul 5, 2026No releases on Jul 12, 2026No releases on Jul 19, 2026No releases on Jul 26, 2026No releases on Aug 2, 2026No releases on Aug 9, 2026
MondayNo releases on Apr 27, 2026No releases on May 4, 2026No releases on May 11, 2026No releases on May 18, 2026No releases on May 25, 2026No releases on Jun 1, 2026No releases on Jun 8, 2026No releases on Jun 15, 2026No releases on Jun 22, 2026No releases on Jun 29, 2026No releases on Jul 6, 2026No releases on Jul 13, 2026No releases on Jul 20, 2026No releases on Jul 27, 2026No releases on Aug 3, 2026No releases on Aug 10, 2026
TuesdayNo releases on Apr 28, 2026No releases on May 5, 2026No releases on May 12, 2026No releases on May 19, 2026No releases on May 26, 2026No releases on Jun 2, 2026No releases on Jun 9, 2026No releases on Jun 16, 2026No releases on Jun 23, 2026No releases on Jun 30, 2026No releases on Jul 7, 2026No releases on Jul 14, 2026No releases on Jul 21, 2026No releases on Jul 28, 2026No releases on Aug 4, 2026
WednesdayNo releases on Apr 29, 2026No releases on May 6, 2026No releases on May 13, 2026No releases on May 20, 2026No releases on May 27, 2026No releases on Jun 3, 2026No releases on Jun 10, 2026No releases on Jun 17, 2026No releases on Jun 24, 2026No releases on Jul 1, 2026No releases on Jul 8, 2026No releases on Jul 15, 2026No releases on Jul 22, 2026No releases on Jul 29, 2026No releases on Aug 5, 2026
ThursdayNo releases on Apr 30, 2026No releases on May 7, 2026No releases on May 14, 2026No releases on May 21, 2026No releases on May 28, 2026No releases on Jun 4, 2026No releases on Jun 11, 2026No releases on Jun 18, 2026No releases on Jun 25, 2026No releases on Jul 2, 2026No releases on Jul 9, 2026No releases on Jul 16, 2026No releases on Jul 23, 2026No releases on Jul 30, 2026No releases on Aug 6, 2026
FridayNo releases on May 1, 2026No releases on May 8, 2026No releases on May 15, 2026No releases on May 22, 2026No releases on May 29, 2026No releases on Jun 5, 2026No releases on Jun 12, 2026No releases on Jun 19, 2026No releases on Jun 26, 2026No releases on Jul 3, 2026No releases on Jul 10, 2026No releases on Jul 17, 2026No releases on Jul 24, 2026No releases on Jul 31, 2026No releases on Aug 7, 2026
SaturdayNo releases on May 2, 2026No releases on May 9, 2026No releases on May 16, 2026No releases on May 23, 2026No releases on May 30, 2026No releases on Jun 6, 2026No releases on Jun 13, 2026No releases on Jun 20, 2026No releases on Jun 27, 20261 release on Jul 4, 2026No releases on Jul 11, 2026No releases on Jul 18, 2026No releases on Jul 25, 2026No releases on Aug 1, 2026No releases on Aug 8, 2026

2 releases in the last year

Changelog

v0.10.0

0.10.0

Added 9
  • import now supports fetching entries from atuin
  • import now auto-detects database files
  • import now skips directories matching $_ZO_EXCLUDE_DIRS
  • Support for non-Cygwin Windows environments such as Busybox on POSIX
  • Fish Space-Tab completions now display and run the selected command
  • Bash/POSIX/Zsh z now honors $CDPATH
Changed 1
  • import now takes a subcommand instead of the --from flag
Fixed 10
  • Bash/POSIX/Zsh z now handles relative paths through symlinked directories
  • Bash/Fish/POSIX/Zsh _ZO_RESOLVE_SYMLINKS now works on Windows
  • Bash handles $PROMPT_COMMAND values ending in a semicolon
  • PowerShell navigates to home directory with z on drives that do not define HOME
  • PowerShell uses fully qualified names when invoking cmdlets
  • Zsh skips doctor diagnostics in non-interactive shells
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.
View originalPermalink
How v0.10.0 went
v0.9.9

0.9.9

Added 2
  • Support for Android ARMv7
  • Fish support for v4.1.0+
Fixed 6
  • Nushell uses sigil operator when calling external commands
  • Zsh supports multiple digits in z +N and z -N dirstack commands
  • Bash avoids downcasting $PROMPT_COMMAND array into a string
  • Bash avoids overwriting $PIPESTATUS
  • POSIX removes non-POSIX compliant calls to builtin
  • 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.
View originalPermalink
How v0.9.9 went
v0.9.8

0.9.8

Added 4
  • Support for Tcsh
  • Added --score flag to zoxide add
  • POSIX: add doctor to diagnose common issues
  • Nushell: add CLI completions
Changed 1
  • Bash: zoxide will now automatically cd when selecting Space-Tab completions
Fixed 8
  • 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
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.
View originalPermalink
How v0.9.8 went
v0.9.7

0.9.7

Added 2
  • Nushell support for version 0.102.0
  • Bash and Zsh doctor command to diagnose common issues
Fixed 1
  • 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.
View originalPermalink
How v0.9.7 went
v0.9.6

0.9.6

Fixed 2
  • Fish: builtin abbr doesn't work on older versions
  • 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.
View originalPermalink
How v0.9.6 went
v0.9.5

0.9.5

Added 8
  • 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, and zsh support for z -- dir style queries
  • Fish improved Space-Tab completions
  • Korn shell support
Changed 2
  • Fzf removed --select-1 from default options
  • Enforce that $_ZO_DATA_DIR is an absolute path
Fixed 7
  • Zsh Space-Tab completion repeating output multiple times when matching single directory
  • Fish, Nushell, and 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
  • Symlinks not getting added to the database when $_ZO_RESOLVE_SYMLINKS=0
  • 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.
View originalPermalink
How v0.9.5 went
v0.9.4

0.9.4

Changed
  • zsh: improved Space-Tab completions.
View originalPermalink
How v0.9.4 went
v0.9.3

0.9.3

Added
  • Nushell: support for v0.89.0.
View originalPermalink
How v0.9.3 went
v0.9.2

0.9.2

Added 1
  • Short option -a for zoxide query --all
Fixed 1
  • PowerShell: use global scope for variables / functions
Added
  • Short option -a for zoxide query --all.
Fixed
  • PowerShell: use global scope for variables / functions.
View originalPermalink
How v0.9.2 went
v0.9.1

0.9.1

Added 5
  • 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 3
  • 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!
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!.
View originalPermalink
How v0.9.1 went
View all

Discussion