interactive-cd
Fish-like interactive tab completion for cd in zsh using fzf for fuzzy directory navigation.
What is interactive-cd?
zsh-interactive-cd is a zsh plugin that provides interactive, fuzzy-search tab completion for the `cd` command using fzf. It allows users to navigate directories by typing partial names and selecting from a filtered list, making shell navigation faster and more intuitive. The plugin integrates directly into zsh's existing tab completion system, requiring no new commands to learn.
Zsh users who frequently navigate complex directory structures and want a more visual, efficient alternative to traditional path typing or basic tab completion.
It offers a seamless, Fish-like navigation experience within zsh, leveraging fzf's powerful fuzzy matching to reduce typing and improve productivity without disrupting existing workflows.
Overview
Fish like interactive tab completion for cd in zsh
Use Cases
Best For
- Quickly switching between deeply nested project directories
- Navigating directories with similar or ambiguous names
- Reducing keystrokes when working in large codebases
- Enhancing terminal productivity with visual search
- Integrating fuzzy search into existing zsh setups
- Users transitioning from Fish shell who want similar navigation in zsh
Not Ideal For
- Users on systems where fzf cannot be installed or is not desired
- Shell environments other than zsh, such as bash or fish
- Automated scripts that require non-interactive directory changes
- Minimalists who prefer a lightweight terminal setup without additional plugins
Pros & Cons
Pros
Leverages fzf for interactive, real-time filtering of directory paths, significantly speeding up navigation in complex structures, as demonstrated in the demo.
Integrates into existing zsh tab completion; pressing tab launches fzf automatically, so no new commands need to be learned.
Provides a selectable interface via fzf, making it intuitive to browse and select from multiple directory options.
Offers one-click installation via Fig, simplifying the setup process for users who utilize this package manager.
Cons
Requires fzf to be installed separately, adding an extra dependency that might not be available or desired in all environments.
Relies solely on fzf's configuration and search syntax, with no built-in options for tailoring the plugin's behavior or interface.
Exclusively designed for zsh, making it incompatible with other shells that might have different navigation needs or built-in features.
Frequently Asked Questions
Related Projects
zoxideA smarter cd command. Supports all major shells.
zsh-autosuggestionsFish-like autosuggestions for zsh
zsh-syntax-highlightingFish shell like syntax highlighting for Zsh.
autojumpA cd command that learns - easily navigate directories from the command line
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.