https://github.com/thestuckster/jumper

ZSH plugin to save and quickly jump to different directories
https://github.com/thestuckster/jumper

Last synced: 16 days ago
JSON representation

ZSH plugin to save and quickly jump to different directories

• Host: GitHub
• URL: https://github.com/thestuckster/jumper
• Owner: thestuckster
• License: mit
• Created: 2025-01-30T22:44:38.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-25T05:48:22.000Z (9 months ago)
• Last Synced: 2025-07-25T10:51:48.611Z (9 months ago)
• Language: Shell
• Size: 10.7 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-zsh-plugins - jumper - Saves your current path and allows you to quickly jump to others. (Plugins / ZSH on Windows)
• fucking-awesome-zsh-plugins - jumper - Saves your current path and allows you to quickly jump to others. (Plugins / ZSH on Windows)
• trackawesomelist - jumper (⭐2) - Saves your current path and allows you to quickly jump to others. (Recently Updated / [Feb 10, 2025](/content/2025/02/10/README.md))

README

          
Jumper

===

A ZSH plugin, Jumper saves your current path and allows you to quickly jump to others 

[Awesome ZSH plugins](https://github.com/unixorn/awesome-zsh-plugins)

![example](./docs/jumper.gif)

## Installation

1) clone this repository to the plugins folder of your zsh installation. 

if you're using oh-my-zsh it will be `~/.oh-my-zsh/custom/plugins`

2) edit your `.zshrc` file to include `jumper` in the plugins

```

plugins=(jumper)

```

3) close and reopen your terminal window

## Usage

Commands and Aliases:

  `jumpAdd [name]`, `ja [name]` : Add current directory to jump list (with optional name)

  `jumpList`, `jl`         : List all saved jump locations

  `jumpRemove `, `jr ` : Remove jump location by ID

  `jump `, `j `    : Jump to location with specified ID

  `jumpBack`, `jb`         : Jump back to the previous directory

  `jumpHelp`, `jh`         : Display this help information

Usage Examples:

  `ja [name]`            : Add current directory (with optional name)

  `jl`                   : List all locations

  `jr 2`                 : Remove location with ID 2

  `j 1`                  : Jump to location with ID 1

  `jb`                   : Jump back to the previous directory

Jumper stores all information in the file displayed in the help message. This file can be edited manually as long as the same format is respected.