Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/catears/goto
Goto - The Good Way to Program
https://github.com/catears/goto
bash cd command-line-tool goto python shell teleport teleportation utility zsh
Last synced: 2 months ago
JSON representation
Goto - The Good Way to Program
- Host: GitHub
- URL: https://github.com/catears/goto
- Owner: CatEars
- License: mit
- Created: 2018-11-25T08:08:03.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2022-06-06T19:40:55.000Z (over 2 years ago)
- Last Synced: 2024-10-03T07:04:41.456Z (3 months ago)
- Topics: bash, cd, command-line-tool, goto, python, shell, teleport, teleportation, utility, zsh
- Language: Rust
- Size: 18.1 MB
- Stars: 16
- Watchers: 4
- Forks: 2
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.txt
- Contributing: Contributing.md
- License: LICENSE
Awesome Lists containing this project
README
# goto
🔖 🔖 🔖 Bookmarks for the terminal 🔖 🔖 🔖
The tldr usage of `goto`:
1. Bookmark with `goto --add ./my_folder`
2. Use `cd` to go somewhere else, or open a new terminal, or restart your computer
3. Run `goto my_folder` and you're teleported back to `my_folder`
Usage gifs and usage documentation can be found in the
[docs folder](https://github.com/CatEars/goto/blob/master/docs/README.md)
## Key Features
* Like browser bookmarks, but for the commandline!
* Add commonly visited places, like `code/my_project` and teleport to it from anywhere!
* Did you say you want auto-completion with that? Of course there is auto-completion!
* Works with bash, zsh and powershell!
* Got several folders with similar names? Use an alias for the bookmark!
## Unnecessary slogan
Goto - The good way to program
## Installing
#### bash
```sh
cargo install --locked goto-cd
goto-cd --install >> ~/.bashrc
```
#### zsh
```sh
cargo install --locked goto-cd
goto-cd --install >> ~/.zshrc
```
#### powershell
```sh
cargo install --locked goto-cd
goto-cd --powershell-install >> $PROFILE
```
#### Finally
Restart your shell for effects to take place
## Basic Usage
Note: The installed binary is called `goto-cd`, but `goto` is the name of the command
loaded into your shell. `goto-cd` is only referenced when installing the first time.
```sh
goto --add .
# Prints "Added 'catears' which points to '/home/catears'"
cd /
goto catears
# Ends up at /home/catears
```
## Updating
```sh
cargo install --locked goto-cd
# Installs the newest version of `goto-cd`
goto --install
# Installs the latest version of shell scripts for both unix/windows
```
## Documentation
See the [docs](https://github.com/CatEars/goto/blob/master/docs/README.md) folder.
## Contributing
See [contributing.md](https://github.com/CatEars/goto/blob/master/Contributing.md).
## License
MIT - see [LICENSE](https://github.com/CatEars/goto/blob/master/LICENSE)