cdx

cdx (Accelerated cd) is a modern, simple and interactive cd command alternative for CLI lovers, written in Rust. It provides a fast and light TUI to incrementally search and navigate directories with ease.

Features

• Interactive TUI: Navigate through directories with an intuitive terminal interface.
• Non-Interactive Mode: Supports standard cd-like usage with arguments for a seamless transition.
• Incremental Search: Quickly filter directories with minimal typing.
• Case-Insensitive Search: Search without distinguishing between uppercase and lowercase letters.
• Keyboard-Driven: Use standard navigation keys for fast and seamless movement.
• Cross-Platform: Built with crossterm, ensuring smooth execution on various platforms.

Installation

Ensure you have Rust and Cargo installed. Then, install cdx via crates.io:

cargo install cdx-rs

From GitHub repository:

cargo install --git https://github.com/Cinnamon-jp/cdx.git

From local source:

git clone https://github.com/Cinnamon-jp/cdx.git
cd cdx
cargo install --path .

Uninstallation

To remove cdx, run:

cargo uninstall cdx-rs

Shell Integration

Because cdx runs as a child process, it cannot directly change the working directory of your current shell. Instead, it prints the selected directory's absolute path to the standard output.

To make it work as a seamless cd replacement, add the initialization command to your shell configuration file.

Note: Ensure that the cargo installation directory (typically ~/.cargo/bin) is included in your system's $PATH. Otherwise, the shell will not be able to find the cdx binary.

bash

Add the following to your ~/.bashrc:

eval "$(cdx init bash)"

zsh

Add the following to your ~/.zshrc:

eval "$(cdx init zsh)"

fish

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

cdx init fish | source

If you prefer to define the wrapper function manually without eval:

bash / zsh:

function cdx() {
    if [ "$1" = "init" ]; then
        command cdx "$@"
        return
    fi
    local dest
    dest=$(command cdx "$@")
    if [ -n "$dest" ] && [ -d "$dest" ]; then
        cd "$dest"
    fi
}

fish:

function cdx
    if test (count $argv) -gt 0 -a "$argv[1]" = "init"
        command cdx $argv
        return
    end
    set dest (command cdx $argv)
    if test -n "$dest" -a -d "$dest"
        cd "$dest"
    end
end

Usage

You can use cdx in two ways (very simple!!):

1. Interactive Mode: Simply type cdx without arguments to open the simple TUI.
2. Direct Mode: Type cdx <directory> to get the absolute path of the target directory. (Useful for scripting or quick resolution).

Keybindings (TUI Mode)

TOML Configuration

You can create config.toml in ~/.config/cdx/ to configure cdx.

[ui]
selected_background_color = "<color>"
selected_foreground_color = "<color>"
path_foreground_color = "<color>"

[system]
use_case_insensitive_search = true | false

• <color>:
  • Named colors: black | gray | white | red | green | yellow | blue | magenta | cyan
    (Prefix with dark for darker shades, e.g., dark red. dark white is an alias for gray.)
  • Hex RGB colors: #RGB or #RRGGBB (e.g., #f00, #ff0000)

Tip: You can use config.schema.json for validation and autocompletion in editors supporting JSON Schema (e.g. Even Better TOML).

Planned Features

• Cyclic Navigation: Support wrap-around selection in the entry list (moving up past the top item jumps to the bottom, and vice versa).
• Colorize Entries List: Use distinct colors for directories, symbolic links, hidden entries, and other entry types to make the list easier to scan.
• Partial Path Navigation: When cdx <path> is executed with a partially invalid path, navigate to the deepest valid directory and launch interactive mode.
• Easy Installation: Distribute pre-compiled binaries via package managers like Homebrew.
• Hidden & Gitignore Support: Add toggles for hidden directories and respect .gitignore rules.
• Vim Keybindings: Support h/j/k/l navigation for power users.
• Directory Bookmarks: Save and jump to your favorite directories instantly.

License

This project is licensed under the MIT License - see the LICENSE file for details.