zdir

zdir (pronounced 'zee-dir', like 'cedar') is a blazingly-faster cd alternative, inspired by zoxide.

It uses a background daemon and socket instead of running everything synchronously when you z or cd into a directory, offering blazingly-fast speeds even on resource-constrained computers.

zdir also features a TUI picker when a query has multiple results with a similar 'frecency' score (see the above image).

benchmarks

as of commit 212325d1, using the bench.nu script on nushell 0.115.1

zoxide benchmark

zdir benchmark

setup

with home-manager

Add the repo to your flake inputs...

{
  inputs = {
    # ...
    zdir = {
      url = "github:indium114/zdir";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };
}

And configure it in home-manager...

{
  inputs,
  ...
}:

{

  programs.zdir = {
    enable = true; # installs the zdir binary and sets up the systemd user service
    enableNushellIntegration = true; # adds the integration script to nushell
  };

}

setting up zdir-librarian, the background daemon

as a systemd user service

Write the following unit file as ~/.config/systemd/user/zdir-librarian.service:

[Unit]
Description=zdir-librarian

[Service]
ExecStart=zdir-librarian

[Install]
WantedBy=default.target

Then, enable and start the service.

systemctl enable --now --user zdir-librarian.service

setting up shell integration

[!note] Currently, there is only shell integration for nushell.
If you are proficient in another shell's scripting language, feel free to write shell integration for that shell and open a pull request.

[!warning] When running with a new database, make sure that the first path you give is a full path. This will allow zdir-librarian to create the table in the database. If you give a nonexistent path the first time, the librarian will panic.

nushell

1. Download the shell/zdir.nu file in this repo.
2. Save it so somewhere like ~/.config/nushell/zdir.nu
3. In your config.nu file (open it by running config nu), add the following line:

source ~/.config/nushell/zdir.nu

Now, assuming the zdir executable is on $env.PATH, it'll work!