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.

Smart suggestions (experimental)

When opening the UI, cdir can suggsts directories based on your current directory, recent activity, and frequency of visits.

This feature is experimental. It is disabled by default but can be activated in the configuration file.

Multi-shell support

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

Data import & export

Export and import your shortcuts, current paths, and complete directory history in YAML format.

Perfect for:

Backup: Save your navigation data
Migration: Move your setup to a new computer
Sharing: Share shortcuts with your team
Version Control: Keep your shortcuts in git with your dotfiles

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.