{"id":44068356,"url":"https://github.com/Adembc/lazyssh","last_synced_at":"2026-02-20T01:00:54.322Z","repository":{"id":311967188,"uuid":"1037246832","full_name":"Adembc/lazyssh","owner":"Adembc","description":"A terminal-based SSH manager inspired by lazydocker and k9s - Written in go","archived":false,"fork":false,"pushed_at":"2025-10-09T20:37:29.000Z","size":1815,"stargazers_count":2691,"open_issues_count":41,"forks_count":82,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-12-10T05:52:06.059Z","etag":null,"topics":["cli","go","golang","lazyssh","scp","ssh","ssh-client","tui","tui-go"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Adembc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-13T09:33:09.000Z","updated_at":"2025-12-10T02:46:43.000Z","dependencies_parsed_at":"2025-09-12T20:15:45.467Z","dependency_job_id":"48eecf0c-f0d2-4d6b-acbe-3024f8b9851d","html_url":"https://github.com/Adembc/lazyssh","commit_stats":null,"previous_names":["adembc/lazyssh"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/Adembc/lazyssh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adembc%2Flazyssh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adembc%2Flazyssh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adembc%2Flazyssh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adembc%2Flazyssh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Adembc","download_url":"https://codeload.github.com/Adembc/lazyssh/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adembc%2Flazyssh/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29637914,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T22:32:43.237Z","status":"ssl_error","status_checked_at":"2026-02-19T22:32:38.330Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","go","golang","lazyssh","scp","ssh","ssh-client","tui","tui-go"],"created_at":"2026-02-08T04:00:24.665Z","updated_at":"2026-02-20T01:00:54.315Z","avatar_url":"https://github.com/Adembc.png","language":"Go","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./docs/logo.png\" alt=\"lazyssh logo\" width=\"600\" height=\"600\"/\u003e\n\u003c/div\u003e\n\n---\n\nLazyssh is a terminal-based, interactive SSH manager inspired by tools like lazydocker and k9s — but built for managing your fleet of servers directly from your terminal.\n\u003cbr/\u003e\nWith lazyssh, you can quickly navigate, connect, manage, and transfer files between your local machine and any server defined in your `~/.ssh/config`. No more remembering IP addresses or running long scp commands — just a clean, keyboard-driven UI.\n\n---\n\n## ✨ Features\n\n### Server Management\n- 📜 Read \u0026 display servers from your `~/.ssh/config` in a scrollable list.\n- ➕ Add a new server from the UI with comprehensive SSH configuration options.\n- ✏ Edit existing server entries directly from the UI with a tabbed interface.\n- 🗑 Delete server entries safely.\n- 📌 Pin / unpin servers to keep favorites at the top.\n- 🏓 Ping server to check status.\n\n### Quick Server Navigation\n- 🔍 Fuzzy search by alias, IP, or tags.\n- 🖥 One‑keypress SSH into the selected server (Enter).\n- 🏷 Tag servers (e.g., prod, dev, test) for quick filtering.\n- ↕️ Sort by alias or last SSH (toggle + reverse).\n\n### Advanced SSH Configuration\n- 🔗 Port forwarding (LocalForward, RemoteForward, DynamicForward).\n- 🚀 Connection multiplexing for faster subsequent connections.\n- 🔐 Advanced authentication options (public key, password, agent forwarding).\n- 🔒 Security settings (ciphers, MACs, key exchange algorithms).\n- 🌐 Proxy settings (ProxyJump, ProxyCommand).\n- ⚙️ Extensive SSH config options organized in tabbed interface.\n\n### Key Management\n- 🔑 SSH key autocomplete with automatic detection of available keys.\n- 📝 Smart key selection with support for multiple keys.\n\n\n### Upcoming\n- 📁 Copy files between local and servers with an easy picker UI.\n- 🔑 SSH Key Deployment Features:\n    - Use default local public key (`~/.ssh/id_ed25519.pub` or `~/.ssh/id_rsa.pub`)\n    - Paste custom public keys manually\n    - Generate new keypairs and deploy them\n    - Automatically append keys to `~/.ssh/authorized_keys` with correct permissions\n---\n\n## 🔐 Security Notice\n\nlazyssh does not introduce any new security risks.\nIt is simply a UI/TUI wrapper around your existing `~/.ssh/config` file.\n\n- All SSH connections are executed through your system’s native ssh binary (OpenSSH).\n\n- Private keys, passwords, and credentials are never stored, transmitted, or modified by lazyssh.\n\n- Your existing IdentityFile paths and ssh-agent integrations work exactly as before.\n\n- lazyssh only reads and updates your `~/.ssh/config`. A backup of the file is created automatically before any changes.\n\n- File permissions on your SSH config are preserved to ensure security.\n\n\n## 🛡️ Config Safety: Non‑destructive writes and backups\n\n- Non‑destructive edits: lazyssh only writes the minimal required changes to your ~/.ssh/config. It uses a parser that preserves existing comments, spacing, order, and any settings it didn’t touch. Your handcrafted comments and formatting remain intact.\n- Atomic writes: updates are written to a temporary file and then atomically renamed over the original, minimizing the risk of partial writes.\n- Backups:\n  - One‑time original backup: before lazyssh makes its first change, it creates a single snapshot named config.original.backup beside your SSH config. If this file is present, it will never be recreated or overwritten.\n  - Rolling backups: on every subsequent save, lazyssh also creates a timestamped backup named like: ~/.ssh/config-\u003ctimestamp\u003e-lazyssh.backup. The app keeps at most 10 of these backups, automatically removing the oldest ones.\n\n## 📷 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\n### 🚀 Startup\n\u003cimg src=\"./docs/loader.png\" alt=\"App starting splash/loader\" width=\"800\" /\u003e\n\nClean loading screen when launching the app\n\n---\n\n### 📋 Server Management Dashboard\n\u003cimg src=\"./docs/list server.png\" alt=\"Server list view\" width=\"900\" /\u003e\n\nMain dashboard displaying all configured servers with status indicators, pinned favorites at the top, and easy navigation\n\n---\n\n### 🔎 Search\n\u003cimg src=\"./docs/search.png\" alt=\"Fuzzy search servers\" width=\"900\" /\u003e\n\nFuzzy search functionality to quickly find servers by name, IP address, or tags\n\n---\n\n### ➕ Add/Edit Server\n\u003cimg src=\"./docs/add server.png\" alt=\"Add a new server\" width=\"900\" /\u003e\n\nTabbed interface for managing SSH connections with extensive configuration options organized into:\n- **Basic** - Host, user, port, keys, tags\n- **Connection** - Proxy, timeouts, multiplexing, canonicalization\n- **Forwarding** - Port forwarding, X11, agent\n- **Authentication** - Keys, passwords, methods, algorithm settings\n- **Advanced** - Security, cryptography, environment, debugging\n\n---\n\n### 🔐 Connect to server\n\u003cimg src=\"./docs/ssh.png\" alt=\"SSH connection details\" width=\"900\" /\u003e\n\nSSH into the selected server\n\n\u003c/div\u003e\n\n---\n\n## 📦 Installation\n\n### Option 1: Homebrew (macOS)\n\n```bash\nbrew install Adembc/homebrew-tap/lazyssh\n```\n\n### Option 2: Download Binary from Releases\n\nDownload from [GitHub Releases](https://github.com/Adembc/lazyssh/releases). You can use the snippet below to automatically fetch the latest version for your OS/ARCH (Darwin/Linux and amd64/arm64 supported):\n\n```bash\n# Detect latest version\nLATEST_TAG=$(curl -fsSL https://api.github.com/repos/Adembc/lazyssh/releases/latest | jq -r .tag_name)\n# Download the correct binary for your system\ncurl -LJO \"https://github.com/Adembc/lazyssh/releases/download/${LATEST_TAG}/lazyssh_$(uname)_$(uname -m).tar.gz\"\n# Extract the binary\ntar -xzf lazyssh_$(uname)_$(uname -m).tar.gz\n# Move to /usr/local/bin or another directory in your PATH\nsudo mv lazyssh /usr/local/bin/\n# enjoy!\nlazyssh\n```\n\n### Option 3: Build from Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/Adembc/lazyssh.git\ncd lazyssh\n\n# Build for macOS\nmake build\n./bin/lazyssh\n\n# Or Run it directly\nmake run\n```\n\n---\n\n## ⌨️ Key Bindings\n\n| Key   | Action                        |\n| ----- | ----------------------------- |\n| /     | Toggle search bar             |\n| ↑↓/jk | Navigate servers              |\n| Enter | SSH into selected server      |\n| c     | Copy SSH command to clipboard |\n| g     | Ping selected server          |\n| r     | Refresh background data       |\n| a     | Add server                    |\n| e     | Edit server                   |\n| t     | Edit tags                     |\n| d     | Delete server                 |\n| p     | Pin/Unpin server              |\n| s     | Toggle sort field             |\n| S     | Reverse sort order            |\n| q     | Quit                          |\n\n**In Server Form:**\n| Key    | Action               |\n| ------ | -------------------- |\n| Ctrl+H | Previous tab         |\n| Ctrl+L | Next tab             |\n| Ctrl+S | Save                 |\n| Esc    | Cancel               |\n\nTip: The hint bar at the top of the list shows the most useful shortcuts.\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome!\n\n- If you spot a bug or have a feature request, please [open an issue](https://github.com/adembc/lazyssh/issues).\n- If you'd like to contribute, fork the repo and submit a pull request ❤️.\n\nWe love seeing the community make Lazyssh better 🚀\n\n### Semantic Pull Requests\n\nThis repository enforces semantic PR titles via an automated GitHub Action. Please format your PR title as:\n\n- type(scope): short descriptive subject\nNotes:\n- Scope is optional and should be one of: ui, cli, config, parser.\n\nAllowed types in this repo:\n- feat: a new feature\n- fix: a bug fix\n- improve: quality or UX improvements that are not a refactor or perf\n- refactor: code change that neither fixes a bug nor adds a feature\n- docs: documentation only changes\n- test: adding or refactoring tests\n- ci: CI/CD or automation changes\n- chore: maintenance tasks, dependency bumps, non-code infra\n- revert: reverts a previous commit\n\nExamples:\n- feat(ui): add server pinning and sorting options\n- fix(parser): handle comments at end of Host blocks\n- improve(cli): show friendly error when ssh binary missing\n- refactor(config): simplify backup rotation logic\n- docs: add installation instructions for Homebrew\n- ci: cache Go toolchain and dependencies\n\nTip: If your PR touches multiple areas, pick the most relevant scope or omit the scope.\n\n---\n\n## ⭐ Support\n\nIf you find Lazyssh useful, please consider giving the repo a **star** ⭐️ and join [stargazers](https://github.com/adembc/lazyssh/stargazers).\n\n☕ You can also support me by [buying me a coffee](https://www.buymeacoffee.com/adembc) ❤️\n\u003cbr/\u003e\n\u003ca href=\"https://buymeacoffee.com/adembc\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" width=\"200\"\u003e\u003c/a\u003e\n\n\n---\n\n## 🙏 Acknowledgments\n\n- Built with [tview](https://github.com/rivo/tview) and [tcell](https://github.com/gdamore/tcell).\n- Inspired by [k9s](https://github.com/derailed/k9s) and [lazydocker](https://github.com/jesseduffield/lazydocker).\n\n","funding_links":["https://www.buymeacoffee.com/adembc","https://buymeacoffee.com/adembc"],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAdembc%2Flazyssh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAdembc%2Flazyssh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAdembc%2Flazyssh/lists"}