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
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 allwitr
Developer Tools
Why is this running? Trace any process, port, container, or file back to what started it -
Apache-2.0★ 23k
golangci-lint
Developer Tools
Fast linters runner for Go
GPL-3.0vs SonarQube Cloud★ 20k
Agent Beacon
Developer Tools
The cross-harness, self-improving memory layer for AI agents.
MIT★ 3.5k
App Store Connect CLI
Developer Tools
Fast, scriptable CLI for the App Store Connect API. Automate TestFlight, builds, submissio
MIT★ 8.3k
TypeUI
Developer Tools
Build better UI with AI
OSS★ 2.2k
Neovim
Developer Tools
Vim-fork focused on extensibility and usability
OSSvs Sublime Text★ 104k
SaaS alternatives to assh
See all
GoLand
Developer Tools
JetBrains IDE for Go development
SaaS
Onepilot
Developer Tools
Mobile SSH terminal and AI agent IDE for iPhone that keeps sessions running when you disconnect
SaaS
termique
Developer Tools
Cross-platform SSH manager and terminal client for macOS, Windows, Linux and iOS with SSH key management and sync
SaaS
Termius
Developer Tools
SSH client and terminal for desktop and mobile with synced hosts
SaaS
act101
Developer Tools
Codebase quality and refactoring toolkit for coding agents, with code porting and verification
SaaS
Angular Material Blocks
Developer Tools
Pre-built Angular Material UI blocks, templates and a CLI for rapid interface development
SaaS
