mirror of
https://github.com/webinstall/webi-installers.git
synced 2026-03-04 02:10:18 +00:00
108 lines
2.1 KiB
Markdown
108 lines
2.1 KiB
Markdown
---
|
|
title: zoxide
|
|
homepage: https://github.com/ajeetdsouza/zoxide
|
|
tagline: |
|
|
zoxide: A smarter cd command.
|
|
---
|
|
|
|
## Cheat Sheet
|
|
|
|
`zoxide` is a smarter `cd` command for your terminal. It keeps track of the
|
|
directories you visit, so that you can switch to them using just a few
|
|
keystrokes.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
```sh
|
|
z foo # cd to highest ranked directory matching foo
|
|
z foo bar # cd to highest ranked directory matching foo and bar
|
|
|
|
z foo/ # can also cd into actual directories
|
|
z .. # cd into parent directory
|
|
z - # cd into previous directory
|
|
|
|
zi foo # cd with interactive selection (requires fzf)
|
|
```
|
|
|
|
## Add zoxide to your shell
|
|
|
|
To use zoxide, it needs to be first initialized on your shell:
|
|
|
|
### `bash`
|
|
|
|
Add this to your configuration (usually `~/.bashrc`):
|
|
|
|
```sh
|
|
eval "$(zoxide init bash)"
|
|
```
|
|
|
|
### `elvish`
|
|
|
|
Add this to your configuration (usually `~/.elvish/rc.elv`):
|
|
|
|
```sh
|
|
eval (zoxide init elvish | slurp)
|
|
```
|
|
|
|
### `fish`
|
|
|
|
Add this to your configuration (usually `~/.config/fish/config.fish`):
|
|
|
|
```fish
|
|
zoxide init fish | source
|
|
```
|
|
|
|
### `nushell 0.32.0+`
|
|
|
|
Initialize zoxide's Nushell script:
|
|
|
|
```sh
|
|
zoxide init nushell --hook prompt | save ~/.zoxide.nu
|
|
```
|
|
|
|
Add this to your configuration (usually `~/.config/nu/config.toml`):
|
|
|
|
```toml
|
|
prompt = "__zoxide_hook;__zoxide_prompt"
|
|
startup = ["zoxide init nushell --hook prompt | save ~/.zoxide.nu", "source ~/.zoxide.nu"]
|
|
```
|
|
|
|
You can replace `__zoxide_prompt` with a custom prompt.
|
|
|
|
### `powershell`
|
|
|
|
Add this to your configuration (the location is stored in `$profile`):
|
|
|
|
```powershell
|
|
Invoke-Expression (& {
|
|
$hook = if ($PSVersionTable.PSVersion.Major -lt 6) { 'prompt' } else { 'pwd' }
|
|
(zoxide init --hook $hook powershell) -join "`n"
|
|
})
|
|
```
|
|
|
|
### `xonsh`
|
|
|
|
Add this to your configuration (usually `~/.xonshrc`):
|
|
|
|
```python
|
|
execx($(zoxide init xonsh), 'exec', __xonsh__.ctx, filename='zoxide')
|
|
```
|
|
|
|
### `zsh`
|
|
|
|
Add this to your configuration (usually `~/.zshrc`):
|
|
|
|
```sh
|
|
eval "$(zoxide init zsh)"
|
|
```
|
|
|
|
### Any POSIX shell
|
|
|
|
Add this to your configuration:
|
|
|
|
```sh
|
|
eval "$(zoxide init posix --hook prompt)"
|
|
```
|