Content
# sshm
> A pretty, AI-friendly SSH connection manager.
>
> Single binary on Win/Mac/Linux. Pretty `ls` with live status. Wizard `add`. Built-in MCP server for AI assistants (Claude Code, Cursor, Codex, Gemini CLI).
## Install
| Platform | Command |
|---|---|
| macOS / Linux (Homebrew) | `brew install michael-ltm/tap/sshm` |
| Windows (Scoop) | `scoop bucket add michael-ltm https://github.com/michael-ltm/scoop-bucket && scoop install sshm` |
| Anywhere (Go) | `go install github.com/michael-ltm/sshm/cmd/sshm@latest` |
| Direct download | [GitHub Releases](https://github.com/michael-ltm/sshm/releases) — tar.gz / zip per OS+arch |
## Quickstart
```
sshm add # interactive wizard
sshm ls # see all servers + status
sshm c my-host # interactive shell
sshm exec my-host 'uptime'
sshm test --all # parallel reachability check
```
## Features
- TOML config at `~/.config/sshm/config.toml` (XDG) or `%APPDATA%\sshm\config.toml` (Windows)
- `add` (huh wizard) / `edit` / `rm` / `show` / `ls`
- `connect` (interactive shell) / `exec` (one-off) / `test` (single + --all)
- `status` (remote resource snapshot) / `init` (baseline hardening)
- `gen-key` (ed25519) / `copy-id` (one-shot password, never stored)
- **`mcp` — built-in MCP server** so AI assistants (Claude Code, Cursor,
Codex, Gemini CLI) can manage your servers. See [docs/ai-integration.md](docs/ai-integration.md).
- `--json` on every command for scripting and AI integration
- Pretty list with unicode/ascii icons (auto-detected)
## AI integration
```
claude plugins marketplace add michael-ltm/sshm
claude plugins install sshm-skill@sshm
```
Then ask your assistant to "check the status of my prod server" or "deploy
the latest code to staging". sshm's MCP tools are audited, mask secrets, and
block dangerous commands. See [docs/ai-integration.md](docs/ai-integration.md)
and [docs/security.md](docs/security.md).
## Roadmap
- **v0.3** — Import/export `~/.ssh/config`, tags/groups, parallel exec, OS keychain
- **v1.0** — Port forwarding, SFTP browse, signed release artifacts, strict known_hosts
See [docs/specs/2026-05-13-sshm-design.md](docs/specs/2026-05-13-sshm-design.md) for the full design.
## Release Process (maintainers)
Releases are automated by GoReleaser on tag push:
```
git tag v0.1.0 && git push origin v0.1.0
```
Required repo secrets: `HOMEBREW_TAP_TOKEN`, `SCOOP_BUCKET_TOKEN` — PATs with `contents:write` on `homebrew-tap` and `scoop-bucket`.
## License
MIT — see [LICENSE](LICENSE).
Connection Info
You Might Also Like
Train-in-Silence
The first Task-Aware MCP server and automated VRAM calculator for LLM...
stacklit
108,000 lines of code. 4,000 tokens of index. One command makes any repo...
AppClaw
AI-powered mobile automation agent — describe what you want in plain...
pdf-mcp
Production-ready MCP server for PDF processing with intelligent caching....
kotadb
Local-only code intelligence API for AI developer workflows (Bun +...
gemini-api-docs-mcp
A remote HTTP MCP server for searching Google Gemini API documentation.