https://github.com/helpermethod/up
Climbing the directory tree at the speed of light.
https://github.com/helpermethod/up
bash bash-completion directory-traversal zsh
Last synced: 2 months ago
JSON representation
Climbing the directory tree at the speed of light.
- Host: GitHub
- URL: https://github.com/helpermethod/up
- Owner: helpermethod
- License: mit
- Created: 2012-05-02T11:35:44.000Z (about 13 years ago)
- Default Branch: main
- Last Pushed: 2025-03-19T07:21:49.000Z (3 months ago)
- Last Synced: 2025-04-13T00:42:10.739Z (2 months ago)
- Topics: bash, bash-completion, directory-traversal, zsh
- Language: Shell
- Homepage:
- Size: 581 KB
- Stars: 16
- Watchers: 2
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# :climbing: up
[](https://github.com/helpermethod/up/actions/workflows/ci.yml)
[](https://github.com/helpermethod/up/blob/main/LICENSE)
> Tired of repeatedly typing `cd ..` to walk up the directory tree? Fed up with defining aliases to jump to the first, second or nth parent directory? `up` to the rescue!
`up` is a shell function for jumping to a parent directory by name.
## :sparkles: Features
* :zap: Lightning fast
* :keyboard: Shell completion for parent directory names
* :shell: Works with Bash and Zsh
## :hammer_and_wrench: Installation
### :shell: Git & Bash
Clone `up`'s Git repository.
```sh
$ git clone https://github.com/helpermethod/up ~/.up
```
Add the following to your `.bashrc` (Linux) or `.bash_profile` (macOS) to install `up`.
```sh
. "$HOME/.up/up"
```
Add the following to your `.bashrc` (Linux) or `.bash_profile` (macOS) to enable `up`'s shell completion.
```sh
. "$HOME/.up/completion/bash/up"
```
### :shell: Git & Zsh
Clone `up`'s Git repository.
```sh
$ git clone https://github.com/helpermethod/up ~/.up
```
Add the following to your `.zshrc` to install `up`.
```sh
. "$HOME/.up/up"
```
Add the following to your `.zshrc` to enable `up`'s shell completion.
```sh
autoload -U +X compinit && compinit
autoload -U +X bashcompinit && bashcompinit
. "$HOME/.up/completion/bash/up"
```
## :mag: Usage
### Get a list of parent directory names
```sh
$ up
.up / Users completion weilero
```
### Jump to a parent directory by name
```sh
$ up weilero
```
### Jump to a parent directory by prefix
```sh
$ up we
```