Features

Below are the main features of cdir:

Directory history

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

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.

Shortcuts

Assign names and optional descriptions to your favorite directories. Return to them quickly from the UI or from the command line.

Search

In the UI, enter text to filter and find any previously visited directory or shortcut. If the default search is not enough, you can use fuzzy search.

Multi-shell support

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

Import shortcuts

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

Color themes

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

Prompt integration

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

Cross-platform

cdir works on both Linux and macOS.