A faster way to cd to commonly used directories.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ge 1eed56422a feat: Bump version to 0.2, see Changelog in README 5 months ago
COPYING init 6 months ago
README feat: Bump version to 0.2, see Changelog in README 5 months ago
goto.sh feat: Bump version to 0.2, see Changelog in README 5 months ago

README

********
G (GOTO)
********

A faster way to cd to commonly used directories. Inspired by commacd. Tested on
Bash 5.1, but should work on most versions.

Installation
************

On most operatin systems with Bash run::

$ curl -o ~/.goto.sh \
-sSL https://gitea.gch.icu/ge/goto/raw/branch/master/goto.sh
$ echo '[ -f ~/.goto.sh ] && . ~/.goto.sh' >> ~/.bashrc

Reread ~/.bashrc by command::

$ source ~/.bashrc

Usage
*****

Available commands (actually is aliases to functions)::

g [<pattern>] goto directory. If you have single bookmark dir will be
changed without prompt. Type dir number in prompt to cd.
g-save [<path>] bookmark $PWD or <path> (save into ~/.goto_saved).

Run `g` to show the entire list of bookmarks and select the one you need.

You don't even need to press `Enter` to confirm your selection -- just type in
the bookmark number. The exception is when you have a two-digit number (or more)
and you select a bookmark whose number is less than 10. Then you have to press
`Enter`.

You can pass the Perl regular expression (processed by grep -Pi) as an for 'g'.
At the same time, if only one bookmark is found, then the directory will be
changed directly to it. If there are several bookmarks, you will be prompted to
choose the appropriate one. Also you can use autocompletion by pressing `Tab`.
It works in a similar way.

Examples
--------

Previously set up your commonly used dirs. Specify dir as argument::

$ g-save ~/Documents
$ g-save ~/Downloads

or cd into dir and simply run::

$ g-save

Go to directory by number::

$ g
0 ~/Documents/
1 ~/Downloads/
: <type number here, e.g. 1>
=> cd /home/user/Downloads

Goto '~/Downloads' directory by regex::

$ g w
=> cd /home/user/Downloads

Another way :)::

$ g 'do[^c]'
=> cd /home/gd/Downloads

and etc.

Changelog
*********

06 Feb 2022
- `~/.gotosave` renamed to `~/.goto_saved`
- Alias `s` changed to `g-save`

07 Jan 2022
Initial release.

Tips
****

Combining `commacd`, `g` and Bash ``autocd`` option gives a great experience!

Add to you ~/.bashrc following line::

shopt -s autocd

Now you can type just directory name without 'cd' to change directory.

Get `commacd` here: https://github.com/shyiko/commacd

Alternatives?
*************

Some `g` alternatives:

- aliases (yep, Bash builtin aliases)
- https://github.com/huyng/bashmarks