mirror of https://github.com/Llewellynvdm/zoxide.git synced 2024-11-16 10:05:20 +00:00

Add POSIX shell support

Any users of a shell that adheres to the POSIX standard should now be
supported. Shells that were tested while this feature was in development
include `mrsh`, `dash`, busybox `ash`, and `bash --posix`.

The hook works by defining a `_zoxide_hook` function and adding it to
the shell's `PS1` (causing it to be evaluated every time the prompt is
redrawn).

The PWD hook has been removed, because it is impossible to implement in
a POSIX-compliant and satisfactory way.

2020-03-30 03:24:37 +05:30

3.3 KiB

Raw Blame History

zoxide

A cd command that learns your habits

Introduction
Examples
Getting started
- Installing zoxide
- Adding zoxide to your shell
  - zsh
  - bash
  - fish
  - POSIX
Configuration
- init flags
- Environment variables

Introduction

zoxide is a blazing fast alternative to cd, inspired by z and z.lua. It keeps track of the directories you use most frequently, and uses a ranking algorithm to navigate to the best match.

Examples

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

zi foo      # cd with interactive selection using fzf

zq foo      # echo the best match, don't cd

za /foo     # add /foo to the database
zr /foo     # remove /foo from the database

Getting started

Step 1: Installing `zoxide`

If you have Rust, this should be as simple as:

cargo install zoxide -f

Otherwise, try the install script:

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/ajeetdsouza/zoxide/master/install.sh | sh

If you want the interactive fuzzy selection feature, you will also need to install fzf.

Step 2: Adding `zoxide` to your shell

If you currently use z, z.lua, or zsh-z, you may want to first migrate your existing database to zoxide:

zoxide migrate /path/to/db

zsh

Add the following line to your ~/.zshrc:

eval "$(zoxide init zsh)"

bash

Add the following line to your ~/.bashrc:

eval "$(zoxide init bash)"

fish

Add the following line to your ~/.config/fish/config.fish:

zoxide init fish | source

POSIX

Add the following line to your shell's configuration file (or, run it manually):

eval "$(zoxide init posix)"

NOTE: If you modify your PS1 at any point, you may need to re-run the above command. This is due to the fact that we store our hook in PS1, in order to be evaluated every time the prompt is displayed.

NOTE: There is no PWD hook provided for POSIX shells.

Configuration

`init` flags

--no-define-aliases: don't define extra aliases like zi, zq, za, and zr
--hook <HOOK>: change the event that adds a new entry to the database (default: prompt)
- none: never add entries - this will make zoxide useless unless you manually configure a hook
- prompt: add an entry at every prompt
- pwd: add an entry whenever you change directories

Environment variables

$_ZO_ECHO: z will print the matched directory before navigating to it
$_ZO_DATA: sets the location of the database (default: ~/.zo)
$_ZO_MAXAGE: sets the maximum total rank after which entries start getting deleted

3.3 KiB Raw Blame History