Skip to content

grafviktor/goto

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

GOTO - A simple SSH manager

License Codecov

This tiny app helps to maintain a list of ssh servers. Unlike PuTTY it doesn't incorporate any connection logic, but relying on ssh utility which should be installed on your system.

Supported platforms: macOS, Linux, Windows.

1. Installation

  • Download the latest version from the Releases section;
  • Choose a binary file which matches your platform;
  • Place the binary into your user's binary path;
  • Optionally: rename gg-${YOUR_PLATFORM_TYPE} to gg.

2. Functional demo

2.1. Edit and connect to a remote box

Small demo where we open ssh session using goto

2.2. Duplicate an existing record

Small demo where duplicate an existing record in goto database

2.3. Find a requried host easily among all your records

Small demo where we open ssh session using goto

3. Configuration

3.1. Command line options

  • -f - application home folder;
  • -l - log verbosity level. Only info(default) or debug values are currently supported;
  • -v - display version and configuration details.

3.2. Environment variables

  • GG_HOME - application home folder;
  • GG_LOG_LEVEL - log verbosity level. Only info(default) or debug values are currently supported.

4. File storage structure

Currently you can only store your hosts in a yaml file, which is called hosts.yaml. The file is located in your user config folder which exact path depends on a running platform:

  • on Linux, it's in $XDG_CONFIG_HOME/goto or $HOME/.config/goto;
  • on Mac, it's in $HOME/Library/Application Support/goto;
  • on Windows, it's in %AppData%\goto.

Usually you don't need to edit this file manually, but sometimes it's much more convenient to edit it into your favorite text editor, than using goto utility. The file structure is very simple and self-explanatory:

- host:
    title: kernel.org
    description: Server 1
    address: 127.0.0.1
- host:
    title: microsoft.com
    description: Server 2
    address: 127.0.0.1
    network_port: 22
    username: satya
    identity_file_path: /home/user/.ssh/id_rsa_microsoft

5. Known issues

Occasional input errors on Windows platform when running goto within cmd.exe. As a workaround run the application using powershell, see the details.