---
name: "zoxide-init"
section: "1"
platform: "linux"
package: "zoxide"
version: "0.10.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/zoxide-init"
---

# zoxide-init(1)

generate shell configuration for zoxide

## NAME

**zoxide-init** - generate shell configuration for zoxide

## SYNOPSIS

**zoxide init SHELL \[OPTIONS\]**

## DESCRIPTION

To initialize zoxide on your shell:

- **bash**

  Add this to the **end** of your config file (usually **~/.bashrc**):

  ```
      eval "$(zoxide init bash)"
  ```

- **elvish**

  Add this to the **end** of your config file (usually **~/.elvish/rc.elv**):

  ```
      eval $(zoxide init elvish | slurp)
  ```

  Note: zoxide only supports elvish v0.18.0 and above.

- **fish**

  Add this to the **end** of your config file (usually **~/.config/fish/config.fish**):

  ```
      zoxide init fish | source
  ```

- **nushell**

  Add this to the **end** of your env file (find it by running **$nu.env-path** in Nushell):

  ```
      zoxide init nushell | save -f ~/.zoxide.nu
  ```

  Now, add this to the **end** of your config file (find it by running **$nu.config-path** in Nushell):

  ```
      source ~/.zoxide.nu
  ```

  Note: zoxide only supports Nushell v0.89.0+.

- **powershell**

  Add this to the **end** of your config file (find it by running **echo** **$profile** in PowerShell):

  ```
      Invoke-Expression (& { (zoxide init powershell | Out-String) })
  ```

- **tcsh**

  Add this to the **end** of your config file (usually **~/.tcshrc**):

  ```
      zoxide init tcsh > ~/.zoxide.tcsh
      source ~/.zoxide.tcsh
  ```

- **xonsh**

  Add this to the **end** of your config file (usually **~/.xonshrc**):

  ```
      execx($(zoxide init xonsh), 'exec', __xonsh__.ctx, filename='zoxide')
  ```

- **zsh**

  Add this to the **end** of your config file (usually **~/.zshrc**):

  ```
      eval "$(zoxide init zsh)"
  ```

- **any POSIX shell**

  Add this to the **end** of your config file:

  ```
      eval "$(zoxide init posix --hook prompt)"
  ```

## OPTIONS

- **--cmd**

  Changes the prefix of the **z** and **zi** commands.\
   **--cmd j** would change the commands to (**j**, **ji**).\
   **--cmd cd** would replace the **cd** command (doesn't work on Nushell / POSIX shells).

- **-h, --help**

  Print help information.

- **--hook HOOK**

  Changes how often zoxide increments a directory's score:

  | | |
  | --- | --- |
  | **none** | Never |
  | **prompt** | At every shell prompt |
  | **pwd** | Whenever the directory is changed |

- **--no-cmd**

  Prevents zoxide from defining the **z** and **zi** commands. These functions will still be available in your shell as **\_\_zoxide\_z** and **\_\_zoxide\_zi**, should you choose to redefine them.

## REPORTING BUGS

For any issues, feature requests, or questions, please visit:

**https://github.com/ajeetdsouza/zoxide/issues**

## AUTHOR

Ajeet D'Souza **\<98ajeet@gmail.com\>**