.TH LSSH 1 "18 Apr 2019" "version 2019.04.18"
.SH NAME
lssh \- a wrapper for Lastpass CLI and ssh-agent
.SH SYNOPSIS
lssh [options] [ssh-key]
.SH DESRIPTION
lssh quickly activates ssh keys by name, filling passwords via Lastpass CLI, and
adding them to ssh-agent. Keys are activated for 1-hour at a time.

The ssh key name provided to
.B lssh
will be used to look up both the key itself and the password for the key. If
that key has a password,
.B lssh
will search Lastpass for an entry named `SSH: [ssh-key]' and autofill the password
with the results. If that entry is not found, `[ssh-key]' will also be attempted
before giving up on a password search. The key will be passed to the ssh-agent
regardless.
.SH OPTIONS
.TP
.B -h
Shows simple help.
.TP
.B -v
Shows current version number.
.SH ENVIRONMENT VARIABLES
.TP
.B SSH_KEY_LOCATIONS
List of folders containing ssh keys.

This environment variable can contain any number of folder paths, space
separated, which will be used to search for the ssh keys. The folders are
searched in order and the search stops at the first successful match.
.TP
.B LASTPASS_USER
Login username to Lastpass. This is used to initiate a login if you are not
already logged in when initiating lssh
.SH EXAMPLES
If you have an ssh key located at ~/.ssh/work/id_rsa, it can be loaded by
entering:

$ lssh work