up
A shell function for quickly navigating to parent directories using tab-completion instead of typing `../` repeatedly.
What is up?
`up` is a shell function that enables quick navigation to parent directories in the terminal using tab-completion, names, or indices. It solves the problem of manually typing `../` repeatedly by providing an intuitive way to move up the directory tree efficiently.
Developers and command-line users who frequently navigate deep directory structures and want to optimize their terminal workflow with faster, less error-prone navigation.
It offers a simpler, more efficient alternative to traditional `cd` commands with `../` patterns, leveraging shell completion for speed and reducing typing errors, all in a lightweight, dependency-free script.
Overview
Quickly navigate to a parent directory via tab-completion.
Use Cases
Best For
- Quickly moving up multiple directory levels without counting `../`
- Navigating to a parent folder by its name when the path is long
- Using tab-completion to explore and select parent directories
- Switching between recent directories with `up -`
- Improving terminal efficiency in deep project structures
- Simplifying shell navigation in bash, zsh, or fish environments
Not Ideal For
- Users who rely on graphical interfaces or IDEs with integrated file navigation, as `up` is terminal-only.
- Systems with restricted shell environments that prevent sourcing external scripts due to security policies.
- Cross-platform developers on Windows without Unix-like shells, since `up` is designed for bash, zsh, and fish.
- Those who prefer comprehensive navigation tools that handle arbitrary paths, not just parent directories.
Pros & Cons
Pros
Enables rapid navigation to parent directories by name with tab-completion, eliminating the need to type full paths, as shown in the README where typing 'up <TAB>' lists available parents.
Supports moving up by index (e.g., 'up 3') or by partial/full name (e.g., 'up ba'), providing multiple intuitive ways to navigate based on context from the examples.
Implemented as pure shell scripts for bash, zsh, and fish with no external dependencies, ensuring minimal overhead and easy integration, per the installation instructions.
Includes 'up -' to return to the previous working directory, simplifying back-and-forth navigation without manual path recall, as specified in the usage section.
Cons
Only moves up to parent directories; cannot navigate to siblings, children, or arbitrary paths without combining with 'cd' or other commands, restricting its utility for complex workflows.
Requires downloading via curl and editing shell configuration files manually, which can be error-prone for users unfamiliar with shell setup, as outlined in the Install section.
Designed exclusively for Unix-like shells (bash, zsh, fish), lacking compatibility with Windows Command Prompt or PowerShell, limiting its reach for cross-platform teams.
Frequently Asked Questions
Related Projects
zoxideA smarter cd command. Supports all major shells.
zz - jump around
autojumpA cd command that learns - easily navigate directories from the command line
z.lua:zap: A new cd command that helps you navigate faster by learning your habits.
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.