assh

Open source

assh is a Go wrapper around ssh that adds regex host matching, aliases, gateways, includes and a YAML configuration file.

GitHub stars
3.2k
Last 30 days
-1(+0%)
Last commit
3 days ago
Repository age
14 years
Version
v2.17.3
Licence
MIT
Self-hosted
Yes

About assh

assh is a transparent wrapper for SSH, written in Go and released under the MIT licence. It adds regex support, aliases, gateways, dynamic hostnames, Graphviz and JSON output, and a YAML configuration file. It plugs in as a ProxyCommand, so it works with ssh, scp, rsync, git and desktop applications that rely on lib-ssh or ssh.

Gateways are the central feature. Typing ssh hosta/hostb connects to hosta through hostb, and chaining further gateways works the same way. In the YAML file a host can list gateways, a connect timeout, and a fallback order such as trying a direct connection first and then going through a gateway, so commands still work from outside a company network. The tool regenerates ~/.ssh/config when needed.

Other configuration features are includes that split settings across files, templates and inheritance between hosts, variable expansion from the environment, per-host or global rate limiting, local command execution and a smart ProxyCommand that uses a raw TCP connection when possible. Hooks such as BeforeConnect and OnConnect can run on connection events, using Go template variables for the host.

Key features

  • Adds regex, aliases and gateways to ssh
  • Works with scp, rsync, git and desktop apps
  • Gateway fallback from direct connection to proxy
  • Templates and host inheritance
  • Per-host or global rate limiting
  • Hooks run before and on connection
  • Regenerates the ssh config file automatically

Good fit for

  • Reach hosts behind gateways with one command
  • Share settings across many hosts with templates
  • Keep ssh config in YAML
Built with
Go tools
Tags
ssh
config
gateway
proxy
devops
go
cli

assh: questions and answers

What is assh used for?
assh is a Go wrapper around ssh that adds regex host matching, aliases, gateways, includes and a YAML configuration file. It is a good fit for reach hosts behind gateways with one command, share settings across many hosts with templates and keep ssh config in YAML.
Is assh open source?
Yes. assh is open source under the MIT licence. Its source code is on GitHub at moul/assh and is written mainly in Go.
Is assh free?
Yes. assh is open source, so the software itself is free to use.
What are some alternatives to assh?
Similar open-source tools in the Developer Tools category include witr, golangci-lint and Agent Beacon. SaaS products in the same category include GoLand, Onepilot and termique.
Is assh actively maintained?
Yes. The most recent commit to assh was on 9 November 2026, and the latest release is v2.17.3, published on 24 July 2026. The project has 3.2k stars on GitHub.

Open-source alternatives to assh

See all

SaaS alternatives to assh

See all