Features

Below are the main features of cdir:

Records your directory history

Every time you use cd to change directories, cdir automatically saves the directory and timestamp.

Quickly navigate to previously visited directories with a console UI

Open the UI with the c command. Use arrow keys and text filtering to select a previously visited directory, then press Enter to jump there instantly.

Directory shortcuts

Assign names and optional descriptions to your favorite directories. Return to them quickly with c <shortcut_name>.

Text search for directories and shortcuts

In the UI, enter text to filter and find any previously visited directory or shortcut.

Supports multiple shells (zsh, bash)

Works with both zsh and bash. More shells may be supported in the future.

Import predefined shortcuts from a YAML file

Define your shortcuts in a YAML file and import them on any computer for easy setup.

Customizable colors

Choose from several built-in color themes, or customize theme colors to match your preferences. You can also create your own theme from scratch.

Shell prompt

Use cdir to display your current working directory in your shell prompt, with shortcuts and custom formatting.

Supports multiple platforms (Linux, macOS)

cdir works on both Linux and macOS.