cx — directory navigation by alias

NOTE: this project was generated by AI. Use at your own risk.

Jump to any directory with a short name. cx lets you define aliases for commonly used directories and navigate to them instantly — with bash completion, auto-assigned letter shortcuts, and sub-path navigation.

cx add src ~/projects/src
cx src                          # cd to ~/projects/src
c                               # cd by letter shortcut
cx src/sub/module               # cd with sub-path
cx -                            # cd to previous dir

Install

pip install cx-command

Then add shell integration to your ~/.bashrc:

eval "$(cx init bash)"

Restart your shell or source ~/.bashrc. That's it.

Usage

Config

Aliases are stored in ~/.cxrc.toml. The file is created automatically on first use.

[settings]
history_size = 50

[openers]
code = "code"
explorer = "explorer"

[aliases]
src = "${PROJECTS}/src"
nb  = "~/notebook"

[aliases.projects]
foo = "~/projects/foo"
bar  = "~/projects/bar"

• Paths support ${VAR}, $VAR environment variable expansion and ~ home expansion.
• Letters (a, b, c, ... aa, ab, ...) are auto-assigned in the order aliases appear.
• Groups are for display only — all names are globally unique.
• Openers are named commands for cx open. The default opener is xdg-open on Linux, open on macOS, explorer on Cygwin/Windows.

Scripting

cx which writes the resolved path to stdout without any shell directives, so it's safe for subshell use:

cd "$(cx which foo)/conf"
cp "$(cx which foo)/config.yaml" .