autojump
A command-line tool that learns your most-used directories and enables fast navigation with fuzzy matching.
What is autojump?
autojump is a command-line tool that accelerates directory navigation by learning which folders you use most frequently. It replaces repetitive `cd` commands with quick jumps using keywords, making terminal workflow more efficient. The tool maintains a database of visited directories and calculates weights based on usage patterns.
Developers, system administrators, and power users who spend significant time in terminal environments and want to optimize filesystem navigation.
It reduces typing and memorization of paths by providing intelligent, fuzzy-matched directory jumps. Unlike aliases or bookmarks, autojump adapts automatically to user behavior without manual setup.
Overview
A cd command that learns - easily navigate directories from the command line
Use Cases
Best For
- Quickly navigating between frequently used project directories
- Reducing terminal fatigue from typing long or complex paths
- Switching between deep nested folder structures efficiently
- Users who work across multiple projects or codebases daily
- Shell users seeking productivity enhancements without heavy configuration
- Teams wanting consistent navigation shortcuts across environments
Not Ideal For
- Systems where shell prompt modification ($PROMPT_COMMAND) is restricted or conflicts with existing configurations
- Environments with ephemeral directories that are created and deleted frequently without reuse
- Users who need to navigate to directories with names starting with '-', which autojump does not support
Pros & Cons
Pros
Automatically tracks and weights directories based on usage frequency, eliminating the need for manual bookmarking or alias setup, as highlighted in its philosophy of reducing friction through learning.
Enables jumps with partial directory names, such as 'j proj' for 'projects', speeding up navigation without memorizing full paths, as demonstrated in the USAGE section.
The 'jc' command prioritizes subdirectories over parent matches, making it efficient for deep folder hierarchies, with examples like 'jc foo' for faster access to nested content.
Works on Linux, macOS, Windows, and BSD with integration for multiple shells, though first-class support is limited to bash and zsh, as noted in the REQUIREMENTS.
Cons
Only bash and zsh have first-class support; other shells and platforms rely on community contributions, which may result in slower updates or unresolved issues, as admitted in the README.
Directories must be visited at least once before jumping, so it's ineffective for new or infrequently accessed paths until usage data accumulates, a core limitation stated upfront.
In bash, it modifies $PROMPT_COMMAND, which can clash with custom prompt setups if not appended correctly, as warned in the KNOWN ISSUES section, adding complexity to setup.
Frequently Asked Questions
Related Projects
fzf:cherry_blossom: A command-line fuzzy finder
ripgrepripgrep recursively searches directories for a regex pattern while respecting your gitignore
tldrCollaborative cheatsheets for console commands 📚.
zoxideA smarter cd command. Supports all major shells.
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.