subroutine login
The 2 commands under subroutine login, each with its arguments and options.
subroutine login [OPTIONS] COMMAND [ARGS]...
Let somebody sign in to the web interface.
subroutine login link
subroutine login link [OPTIONS]
Make a sign-in link for the web interface, and print it once.
Examples:
subroutine login link
subroutine login link --username thomas
Hand it over however you would hand over anything private — it signs in as whoever it names, once, and stops working after half an hour.
This is also the way back in when email is not set up or is not working, which is why it exists at a terminal rather than only in a browser: the console has to be a way in when the ordinary path is broken.
Options
--username(str): Issue for somebody else, by the name 'user list' shows. Unset means you.
subroutine login revoke
subroutine login revoke [OPTIONS] {username}
Sign somebody out of every browser they are signed in on.
Examples:
subroutine login revoke thomas
Immediate, and it takes any unused sign-in links with it. This is what a lost laptop needs; it does not touch their API tokens, which 'subroutine token revoke' stops.
Arguments
username(str, required): Whose sessions to end, by the name 'user list' shows.