Features
-
Auto-suggest hostnames from
~/.ssh/config,~/.ssh/known_hosts,/etc/ssh/ssh_configand/etc/hosts(sources can be individually disabled). - Remembers usernames, so you don't have to type them in every time. (You can also remove connections from your history or disable it entirely.)
-
Alternate actions:
- Open connection with mosh instead of SSH.
- Open SFTP connection instead of SSH.
- Ping host.
Usage
Keyword is ssh:
-
ssh [<query>]— View and filter known SSH connections.-
↩or⌘+<NUM>— Open the connection. -
⇥— Expand query to selected connection's title. Useful for adding a port number. -
⌘+↩— Open an SFTP connection instead. -
⌘+⌥— Open a mosh connection instead. -
⇧+↩— Ping host. -
^+↩— Forget connection (if it's from history).
-
Configuration
There are several options available in the workflow's configuration sheet. Notably, you can turn off individual autosuggestion sources.
| Variable | Description |
|---|---|
DISABLE_CONFIG |
Set to 1 to turn off
suggestions from
~/.ssh/config.
|
DISABLE_ETC_CONFIG
|
Set to 1 to turn off
suggestions from
/etc/ssh/ssh_config.
|
DISABLE_ETC_HOSTS
|
Set to 1 to turn off
suggestions from
/etc/hosts.
|
DISABLE_HISTORY |
Set to 1 to disable the
History (reading and writing).
|
DISABLE_KNOWN_HOSTS
|
Set to 1 to turn off
suggestions from
~/.ssh/known_hosts.
|
EXIT_ON_SUCCESS |
Set to 1 (default) to
close shell if ping or
mosh command exits
cleanly
|
EXTERNAL_TRIGGER |
Set to 1 to use an
External Trigger instead of
AppleScript to re-open Alfred. The
External Trigger is safer, but
leaves Alfred in a weird mode.
|
MOSH_CMD |
Set to the full path to
mosh if your shell
can't find it. Set to empty to
disable
mosh connections.
|
Please note: The workflow
generates an ssh:// (or
sftp://) URL and asks Alfred
to open it. Similarly, the
ping and
mosh features uses Alfred 3's
Terminal Command feature. If it's not
opening in the right app, it's not the
workflow's fault.
Licencing & thanks
This workflow is released under the MIT Licence.
It uses the following libraries and resources:
- The icon is based on Octicons by Github (SIL Licence).
- ssh_config (MIT Licence) to parse SSH config files.
- awgo (MIT Licence) for the workflowy stuff.
This workflow started as a port of @isometry's Python SSH workflow to Go as a testbed for awgo. It has since gained some additional features.
If you need Alfred 2 support, check out @isometry's workflow.
Changelog
-
v0.7.1 — 2016-12-12
- Fix updater bug
-
Smarter SSH URLs for hosts from
~/.ssh/config - Better removal of duplicates
-
v0.6.0 — 2016-11-09
- Add in-workflow updates
-
v0.5.0 — 2016-10-31
-
Add support for SSH configuration
files (
~/.ssh/configand/etc/ssh/ssh_config) -
Alternate action: open connection
with
mosh
-
Add support for SSH configuration
files (
-
v0.4.0 — 2016-05-27
- Add ability to turn sources of suggestions off #1
-
v0.3.0 — 2016-05-26
- Alternate action: Open SFTP connection
- Alternate action: Ping host
- Remember connections with usernames, so you don't have to type the username each time
-
v0.2.0 — 2016-05-23
- First public release
