https://github.com/haensl/goto
Bash completion for fast project navigation.
https://github.com/haensl/goto
autocomplete autocompletion bash bash-completion bash-script goto
Last synced: 4 months ago
JSON representation
Bash completion for fast project navigation.
- Host: GitHub
- URL: https://github.com/haensl/goto
- Owner: haensl
- License: mit
- Created: 2018-01-03T11:05:32.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-02-02T23:35:32.000Z (over 4 years ago)
- Last Synced: 2025-01-08T02:22:50.334Z (6 months ago)
- Topics: autocomplete, autocompletion, bash, bash-completion, bash-script, goto
- Language: Shell
- Size: 8.33 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# goto [](https://circleci.com/gh/haensl/goto)
Bash completion for fast project navigation.
## Prerequisites
* `bash`: goto is written for bash (and compatible) shells.
* `bash-completion`: ensure that your shell has completion available. You can check by running:
```shell
(command -v complete &> /dev/null && echo 'You have bash completion.') || echo 'You do not have bash completion'
```
## Installation
1. Get a hold of goto. You can either clone this repository or [download the latest release](https://github.com/haensl/goto/releases).
2. Load goto in your Bash profile (usually `~/.bashrc` on Linux and `~/.bash_profile` on MacOS)
```
source /path/to/goto/goto
```
Specify the directories that contain your projects via the `GOTOPATH` environment variable. To specify multiple directories, separate them via : (colon), e.g.:
```
export GOTOPATH="${HOME}/code:${HOME}/sites"
```
You can view installation instructions by running
```
make install
```
## Usage
* Type `goto` and the start of whatever project/folder you want to navigate to in your terminal.
E.g.
```
goto gul
```
* Hit `` for autocompletion. If there are several options, this will complete the directory name as far as possible.
E.g.
```
goto gulp-embed-
```
* Hit `` again for a list of possible completions.
E.g.
```
goto gulp-embed-
gulp-embed-json gulp-embed-svg
```
* Continue typing/autocompleting the desired project/folder name and hit enter to go there.
### [CHANGELOG](CHANGELOG.md)
### [LICENSE](LICENSE)