summaryrefslogtreecommitdiffstats
path: root/zsh/oh-my-zsh/plugins/jump/README.md
blob: 1b0ce68c034066f95dce2c2eb3d36efb161c400e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# Jump plugin

This plugin allows to easily jump around the file system by manually adding marks.
Those marks are stored as symbolic links in the directory `$MARKPATH` (default `$HOME/.marks`)

To use it, add `jump` to the plugins array in your zshrc file:

```zsh
plugins=(... jump)
```

## Commands

| Command              | Description                                                                                     |
|----------------------|-------------------------------------------------------------------------------------------------|
| `jump <mark-name>`   | Jump to the given mark                                                                          |
| `mark [mark-name]`   | Create a mark with the given name or with the name of the current directory if none is provided |
| `unmark <mark-name>` | Remove the given mark                                                                           |
| `marks`              | List the existing marks and the directories they point to                                       |

## Key bindings

Pressing `CTRL`+`G` substitutes the written mark name for the full path of the mark.
For example, with a mark named `mymark` pointing to `/path/to/my/mark`:
```zsh
$ cp /tmp/file mymark<C-g>
```
will become:
```zsh
$ cp /tmp/file /path/to/my/mark
```