sshm-terminal 1.0.0__tar.gz

sshm_terminal-1.0.0/.gitignore

@@ -0,0 +1,23 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+*.egg
+dist/
+build/
+
+# Virtual environment
+.venv/
+
+# Environment variables
+.env
+
+# macOS
+.DS_Store
+
+# IDE
+.vscode/
+.idea/
+
+# Claude Code
+.claude/

sshm_terminal-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rajesh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sshm_terminal-1.0.0/PKG-INFO

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: sshm-terminal
+Version: 1.0.0
+Summary: Terminal SSH connection manager with macOS Keychain integration and Matrix-themed TUI
+Project-URL: Homepage, https://github.com/dailydeploy365/sshm
+Project-URL: Repository, https://github.com/dailydeploy365/sshm
+Project-URL: Issues, https://github.com/dailydeploy365/sshm/issues
+Author: Rajesh
+License-Expression: MIT
+License-File: LICENSE
+Keywords: connection-manager,keychain,macos,ssh,terminal,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Terminals
+Requires-Python: >=3.10
+Requires-Dist: textual>=0.80.0
+Description-Content-Type: text/markdown
+
+# SSHM - SSH Connection Manager
+
+A terminal-based SSH connection manager for macOS with a Matrix-themed TUI. Store server credentials securely (passwords in macOS Keychain), and connect with a single keypress.
+
+![Python](https://img.shields.io/badge/python-3.10+-00ff41?style=flat-square&logo=python&logoColor=00ff41&labelColor=0d0208)
+![macOS](https://img.shields.io/badge/macOS-supported-00ff41?style=flat-square&logo=apple&logoColor=00ff41&labelColor=0d0208)
+![License](https://img.shields.io/badge/license-MIT-00ff41?style=flat-square&labelColor=0d0208)
+
+## Features
+
+- **Interactive TUI** - Navigate servers with arrow keys, connect with Enter
+- **Secure password storage** - Passwords saved in macOS Keychain (never plaintext)
+- **Auto sudo** - Optionally elevate to root automatically after SSH login
+- **Search/filter** - Quickly find servers by name, host, user, or group
+- **Copy SSH command** - Copy the raw `ssh` command to clipboard
+- **Matrix theme** - Green-on-black hacker aesthetic
+
+## Install
+
+### Option A: pipx (recommended)
+
+One command, no manual venv or alias needed:
+
+```bash
+pipx install sshm-terminal
+```
+
+> Don't have pipx? Install it first: `brew install pipx && pipx ensurepath`
+
+### Option B: Homebrew
+
+```bash
+brew tap dailydeploy365/tap https://github.com/dailydeploy365/homebrew-tap
+brew install sshm
+```
+
+### Option C: From source (for development)
+
+```bash
+git clone https://github.com/dailydeploy365/sshm.git
+cd sshm
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+Then add an alias so `sshm` works from anywhere:
+
+```bash
+# Add to ~/.zshrc
+alias sshm="/path/to/sshm/.venv/bin/sshm"
+source ~/.zshrc
+```
+
+### Optional: install sshpass for cleaner password auth
+
+```bash
+brew install esolitos/ipa/sshpass
+```
+
+Without it, the app falls back to macOS built-in `expect` which works fine.
+
+## Requirements
+
+- macOS (uses `security` CLI for Keychain and `expect` for password automation)
+- Python 3.10+
+
+## Usage
+
+### Launch the TUI
+
+```bash
+sshm
+```
+
+### Quick list from the terminal
+
+```bash
+sshm list
+```
+
+### TUI Keybindings
+
+| Key       | Action                          |
+|-----------|---------------------------------|
+| `a`       | Add a new server                |
+| `e`       | Edit selected server            |
+| `d`       | Delete selected server          |
+| `Enter`   | SSH into selected server        |
+| `c`       | Copy SSH command to clipboard   |
+| `/`       | Search / filter servers         |
+| `Esc`     | Close search, or quit           |
+| `q`       | Quit                            |
+
+### Add/Edit Form
+
+| Key       | Action           |
+|-----------|------------------|
+| `ctrl+s`  | Save             |
+| `Esc`     | Cancel           |
+| `Tab`     | Next field       |
+
+### Delete Confirmation
+
+| Key           | Action    |
+|---------------|-----------|
+| `y` / `Enter` | Confirm  |
+| `n` / `Esc`   | Cancel   |
+
+## How-To: Add and connect to a server
+
+**Step 1** - Run `sshm`
+
+**Step 2** - Press `a` to open the Add Server form
+
+**Step 3** - Fill in the fields:
+
+```
+Name:       Production API
+Host / IP:  192.168.1.50
+Port:       2222
+User:       deploy
+Group:      production
+Password:   ••••••••
+SSH Key:    (leave empty if using password)
+```
+
+Check **"Auto sudo"** if you want to automatically get a root shell after login.
+
+**Step 4** - Press `ctrl+s` to save
+
+**Step 5** - Select the server in the list and press `Enter` to connect
+
+That's it. Next time, just `sshm` → arrow to your server → `Enter`.
+
+## How-To: Use SSH key instead of password
+
+**Step 1** - When adding/editing a server, leave the Password field empty
+
+**Step 2** - Fill in the SSH Key Path field:
+
+```
+SSH Key Path:  ~/.ssh/id_rsa
+```
+
+**Step 3** - Save with `ctrl+s`
+
+The app will use `ssh -i ~/.ssh/id_rsa` when connecting.
+
+## How-To: Copy the SSH command
+
+Select a server and press `c`. The raw SSH command gets copied to your clipboard:
+
+```
+ssh -p 2222 deploy@192.168.1.50
+```
+
+Useful for scripts, sharing with teammates, or pasting into another terminal.
+
+## How it works
+
+| What              | Where                                      |
+|-------------------|--------------------------------------------|
+| Server metadata   | `~/.sshm/servers.json`                     |
+| Passwords         | macOS Keychain (via `security` CLI)         |
+| SSH connection    | `sshpass` if installed, else `expect`       |
+| Auto sudo         | `expect` script (SSH login + `sudo -i`)    |
+
+## CLI Commands
+
+```
+sshm          Open the TUI manager
+sshm list     List saved servers in the terminal
+sshm help     Show usage info
+```
+
+## Uninstall
+
+```bash
+# Remove the alias from ~/.zshrc
+# Then:
+rm -rf ~/.sshm            # Remove server data
+pip uninstall sshm         # Remove the package
+```
+
+Passwords stored in macOS Keychain can be removed via Keychain Access.app (search for "sshm").

sshm_terminal-1.0.0/README.md

@@ -0,0 +1,186 @@
+# SSHM - SSH Connection Manager
+
+A terminal-based SSH connection manager for macOS with a Matrix-themed TUI. Store server credentials securely (passwords in macOS Keychain), and connect with a single keypress.
+
+![Python](https://img.shields.io/badge/python-3.10+-00ff41?style=flat-square&logo=python&logoColor=00ff41&labelColor=0d0208)
+![macOS](https://img.shields.io/badge/macOS-supported-00ff41?style=flat-square&logo=apple&logoColor=00ff41&labelColor=0d0208)
+![License](https://img.shields.io/badge/license-MIT-00ff41?style=flat-square&labelColor=0d0208)
+
+## Features
+
+- **Interactive TUI** - Navigate servers with arrow keys, connect with Enter
+- **Secure password storage** - Passwords saved in macOS Keychain (never plaintext)
+- **Auto sudo** - Optionally elevate to root automatically after SSH login
+- **Search/filter** - Quickly find servers by name, host, user, or group
+- **Copy SSH command** - Copy the raw `ssh` command to clipboard
+- **Matrix theme** - Green-on-black hacker aesthetic
+
+## Install
+
+### Option A: pipx (recommended)
+
+One command, no manual venv or alias needed:
+
+```bash
+pipx install sshm-terminal
+```
+
+> Don't have pipx? Install it first: `brew install pipx && pipx ensurepath`
+
+### Option B: Homebrew
+
+```bash
+brew tap dailydeploy365/tap https://github.com/dailydeploy365/homebrew-tap
+brew install sshm
+```
+
+### Option C: From source (for development)
+
+```bash
+git clone https://github.com/dailydeploy365/sshm.git
+cd sshm
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+Then add an alias so `sshm` works from anywhere:
+
+```bash
+# Add to ~/.zshrc
+alias sshm="/path/to/sshm/.venv/bin/sshm"
+source ~/.zshrc
+```
+
+### Optional: install sshpass for cleaner password auth
+
+```bash
+brew install esolitos/ipa/sshpass
+```
+
+Without it, the app falls back to macOS built-in `expect` which works fine.
+
+## Requirements
+
+- macOS (uses `security` CLI for Keychain and `expect` for password automation)
+- Python 3.10+
+
+## Usage
+
+### Launch the TUI
+
+```bash
+sshm
+```
+
+### Quick list from the terminal
+
+```bash
+sshm list
+```
+
+### TUI Keybindings
+
+| Key       | Action                          |
+|-----------|---------------------------------|
+| `a`       | Add a new server                |
+| `e`       | Edit selected server            |
+| `d`       | Delete selected server          |
+| `Enter`   | SSH into selected server        |
+| `c`       | Copy SSH command to clipboard   |
+| `/`       | Search / filter servers         |
+| `Esc`     | Close search, or quit           |
+| `q`       | Quit                            |
+
+### Add/Edit Form
+
+| Key       | Action           |
+|-----------|------------------|
+| `ctrl+s`  | Save             |
+| `Esc`     | Cancel           |
+| `Tab`     | Next field       |
+
+### Delete Confirmation
+
+| Key           | Action    |
+|---------------|-----------|
+| `y` / `Enter` | Confirm  |
+| `n` / `Esc`   | Cancel   |
+
+## How-To: Add and connect to a server
+
+**Step 1** - Run `sshm`
+
+**Step 2** - Press `a` to open the Add Server form
+
+**Step 3** - Fill in the fields:
+
+```
+Name:       Production API
+Host / IP:  192.168.1.50
+Port:       2222
+User:       deploy
+Group:      production
+Password:   ••••••••
+SSH Key:    (leave empty if using password)
+```
+
+Check **"Auto sudo"** if you want to automatically get a root shell after login.
+
+**Step 4** - Press `ctrl+s` to save
+
+**Step 5** - Select the server in the list and press `Enter` to connect
+
+That's it. Next time, just `sshm` → arrow to your server → `Enter`.
+
+## How-To: Use SSH key instead of password
+
+**Step 1** - When adding/editing a server, leave the Password field empty
+
+**Step 2** - Fill in the SSH Key Path field:
+
+```
+SSH Key Path:  ~/.ssh/id_rsa
+```
+
+**Step 3** - Save with `ctrl+s`
+
+The app will use `ssh -i ~/.ssh/id_rsa` when connecting.
+
+## How-To: Copy the SSH command
+
+Select a server and press `c`. The raw SSH command gets copied to your clipboard:
+
+```
+ssh -p 2222 deploy@192.168.1.50
+```
+
+Useful for scripts, sharing with teammates, or pasting into another terminal.
+
+## How it works
+
+| What              | Where                                      |
+|-------------------|--------------------------------------------|
+| Server metadata   | `~/.sshm/servers.json`                     |
+| Passwords         | macOS Keychain (via `security` CLI)         |
+| SSH connection    | `sshpass` if installed, else `expect`       |
+| Auto sudo         | `expect` script (SSH login + `sudo -i`)    |
+
+## CLI Commands
+
+```
+sshm          Open the TUI manager
+sshm list     List saved servers in the terminal
+sshm help     Show usage info
+```
+
+## Uninstall
+
+```bash
+# Remove the alias from ~/.zshrc
+# Then:
+rm -rf ~/.sshm            # Remove server data
+pip uninstall sshm         # Remove the package
+```
+
+Passwords stored in macOS Keychain can be removed via Keychain Access.app (search for "sshm").

sshm_terminal-1.0.0/homebrew-tap/Formula/sshm.rb

@@ -0,0 +1,24 @@
+class Sshm < Formula
+  include Language::Python::Virtualenv
+
+  desc "Terminal SSH connection manager with Matrix-themed TUI and macOS Keychain integration"
+  homepage "https://github.com/rajesh/sshm"
+  url "https://pypi.io/packages/source/s/sshm-terminal/sshm_terminal-1.0.0.tar.gz"
+  sha256 "2dbe18ce5210eeeb02202b78d3e5bc45c9685787feaeb03717f9a88cef1a9ddb"
+  license "MIT"
+
+  depends_on "python@3.13"
+
+  resource "textual" do
+    url "https://pypi.io/packages/source/t/textual/textual-8.2.4.tar.gz"
+    sha256 "PLACEHOLDER"
+  end
+
+  def install
+    virtualenv_install_with_resources
+  end
+
+  test do
+    assert_match "Usage", shell_output("#{bin}/sshm help")
+  end
+end

sshm_terminal-1.0.0/homebrew-tap/README.md

@@ -0,0 +1,23 @@
+# homebrew-tap
+
+Homebrew formulae for SSHM - Terminal SSH Connection Manager.
+
+## Install
+
+```bash
+brew tap rajesh/tap https://github.com/rajesh/homebrew-tap
+brew install sshm
+```
+
+## Update
+
+```bash
+brew upgrade sshm
+```
+
+## Uninstall
+
+```bash
+brew uninstall sshm
+brew untap rajesh/tap
+```

sshm_terminal-1.0.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sshm-terminal"
+version = "1.0.0"
+description = "Terminal SSH connection manager with macOS Keychain integration and Matrix-themed TUI"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Rajesh" },
+]
+keywords = ["ssh", "terminal", "tui", "connection-manager", "macos", "keychain"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: System :: Networking",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Terminals",
+]
+dependencies = [
+    "textual>=0.80.0",
+]
+
+[project.scripts]
+sshm = "sshm.app:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["sshm"]
+
+[project.urls]
+Homepage = "https://github.com/dailydeploy365/sshm"
+Repository = "https://github.com/dailydeploy365/sshm"
+Issues = "https://github.com/dailydeploy365/sshm/issues"

sshm_terminal-1.0.0/sshm/__init__.py

@@ -0,0 +1 @@
+"""sshm - Terminal SSH connection manager."""

sshm_terminal-1.0.0/sshm/__main__.py

@@ -0,0 +1,3 @@
+from sshm.app import main
+
+main()

sshm_terminal-1.0.0/sshm/app.py

@@ -0,0 +1,671 @@
+"""SSH Manager - Terminal UI application."""
+
+import os
+import shutil
+import subprocess
+import tempfile
+
+from textual import on
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.containers import Horizontal, Vertical, VerticalScroll
+from textual.screen import ModalScreen
+from textual.widgets import Checkbox, DataTable, Footer, Input, Label, Static
+
+from .storage import Server, Storage
+
+
+# ---------------------------------------------------------------------------
+# SSH connection
+# ---------------------------------------------------------------------------
+
+def ssh_connect(server: Server, password: str):
+    """Connect to a server via SSH. Auto-elevates to root when user is not root."""
+    base_args = ["-o", "StrictHostKeyChecking=accept-new", "-p", str(server.port)]
+
+    if server.sudo and password:
+        _ssh_with_sudo(server, password, base_args)
+    elif server.identity_file:
+        path = os.path.expanduser(server.identity_file)
+        cmd = ["ssh", "-i", path] + base_args + [f"{server.user}@{server.host}"]
+        subprocess.call(cmd)
+    elif password:
+        if shutil.which("sshpass"):
+            env = os.environ.copy()
+            env["SSHPASS"] = password
+            cmd = ["sshpass", "-e", "ssh"] + base_args + [f"{server.user}@{server.host}"]
+            subprocess.call(cmd, env=env)
+        else:
+            _ssh_via_expect(server, password, base_args)
+    else:
+        cmd = ["ssh"] + base_args + [f"{server.user}@{server.host}"]
+        subprocess.call(cmd)
+
+
+def _write_password_file(password: str) -> str:
+    """Write password to a temp file readable only by owner. Returns path."""
+    pw_file = tempfile.NamedTemporaryFile(mode="w", suffix=".pw", delete=False)
+    pw_file.write(password)
+    pw_file.close()
+    os.chmod(pw_file.name, 0o400)
+    return pw_file.name
+
+
+def _run_expect(script: str, pw_path: str):
+    """Run an expect script and clean up the password file."""
+    try:
+        subprocess.call(["expect", "-c", script])
+    finally:
+        if os.path.exists(pw_path):
+            os.unlink(pw_path)
+
+
+def _ssh_via_expect(server: Server, password: str, base_args: list[str]):
+    """Use macOS built-in expect to automate password entry."""
+    args_str = " ".join(base_args)
+    pw_path = _write_password_file(password)
+
+    key_arg = ""
+    if server.identity_file:
+        key_arg = f"-i {os.path.expanduser(server.identity_file)} "
+
+    script = f'''
+set timeout 30
+set f [open "{pw_path}" r]
+set pw [read $f]
+close $f
+file delete "{pw_path}"
+spawn ssh {key_arg}{args_str} {server.user}@{server.host}
+expect {{
+    -re {{[Pp]assword:}} {{ send "$pw\\r"; interact }}
+    -re {{passphrase}}   {{ send "$pw\\r"; interact }}
+    timeout              {{ puts "Connection timed out"; exit 1 }}
+}}
+'''
+    _run_expect(script, pw_path)
+
+
+def _ssh_with_sudo(server: Server, password: str, base_args: list[str]):
+    """SSH in and auto-elevate to root via sudo."""
+    args_str = " ".join(["-t"] + base_args)
+    pw_path = _write_password_file(password)
+
+    key_arg = ""
+    if server.identity_file:
+        key_arg = f"-i {os.path.expanduser(server.identity_file)} "
+
+    script = f'''
+set timeout 30
+set f [open "{pw_path}" r]
+set pw [read $f]
+close $f
+file delete "{pw_path}"
+spawn ssh {key_arg}{args_str} {server.user}@{server.host}
+
+# Handle SSH password
+expect {{
+    -re {{[Pp]assword:}} {{ send "$pw\\r" }}
+    -re {{passphrase}}   {{ send "$pw\\r" }}
+    timeout              {{ puts "SSH timed out"; exit 1 }}
+}}
+
+# Drain MOTD output until we see the shell prompt (user@host:...$ )
+expect {{
+    -re {{@[^:]+:.*\\$ }} {{ }}
+    timeout               {{ }}
+}}
+
+# Elevate to root
+send "sudo -i\\r"
+
+# Handle sudo password then hand over to user
+expect {{
+    -re {{[Pp]assword}} {{ send "$pw\\r"; interact }}
+    -re {{root@}}       {{ interact }}
+    -re {{# }}          {{ interact }}
+    timeout             {{ interact }}
+}}
+'''
+    _run_expect(script, pw_path)
+
+
+# ---------------------------------------------------------------------------
+# Matrix color palette
+# ---------------------------------------------------------------------------
+
+C_BG = "#0d0208"
+C_SURFACE = "#0a1a0a"
+C_PANEL = "#0f1a0f"
+C_GREEN_BRIGHT = "#00ff41"
+C_GREEN_MID = "#00cc33"
+C_GREEN_DIM = "#008f11"
+C_GREEN_DARK = "#003b00"
+C_GREEN_MUTED = "#337733"
+C_RED = "#ff3333"
+C_RED_DARK = "#661111"
+
+
+# ---------------------------------------------------------------------------
+# Screens
+# ---------------------------------------------------------------------------
+
+class ServerForm(ModalScreen[Server | None]):
+    """Modal form for adding or editing a server."""
+
+    CSS = f"""
+    ServerForm {{
+        align: center middle;
+        background: {C_BG} 80%;
+    }}
+    #form-box {{
+        width: 65;
+        max-height: 90%;
+        border: solid {C_GREEN_DIM};
+        background: {C_BG};
+        padding: 1 2;
+    }}
+    #form-fields {{
+        height: 1fr;
+        background: {C_BG};
+    }}
+    #form-title {{
+        text-align: center;
+        text-style: bold;
+        width: 100%;
+        color: {C_GREEN_BRIGHT};
+    }}
+    .field-label {{
+        margin-top: 0;
+        color: {C_GREEN_DIM};
+    }}
+    #form-box Input {{
+        width: 100%;
+        background: {C_SURFACE};
+        color: {C_GREEN_BRIGHT};
+        border: tall {C_GREEN_DARK};
+    }}
+    #form-box Input:focus {{
+        border: tall {C_GREEN_BRIGHT};
+    }}
+    #form-box Checkbox {{
+        background: transparent;
+        color: {C_GREEN_MID};
+        padding: 0 2;
+    }}
+    #form-box Checkbox:focus {{
+        color: {C_GREEN_BRIGHT};
+    }}
+    #form-hints {{
+        width: 100%;
+        height: 1;
+        content-align: center middle;
+        color: {C_GREEN_DIM};
+        margin-top: 1;
+    }}
+    """
+
+    BINDINGS = [
+        Binding("ctrl+s", "save", "Save", show=False),
+        Binding("escape", "cancel", "Cancel", show=False),
+    ]
+
+    def __init__(self, server: Server | None = None, password: str = ""):
+        super().__init__()
+        self.server = server
+        self._password = password
+
+    def compose(self) -> ComposeResult:
+        editing = self.server is not None
+        s = self.server
+
+        with Vertical(id="form-box"):
+            with VerticalScroll(id="form-fields"):
+                yield Static(
+                    f"[bold {C_GREEN_BRIGHT}]// {'Edit' if editing else 'New'} Server[/]",
+                    id="form-title",
+                )
+
+                yield Label("Name", classes="field-label")
+                yield Input(value=s.name if editing else "", placeholder="My Server", id="inp-name")
+
+                yield Label("Host / IP", classes="field-label")
+                yield Input(value=s.host if editing else "", placeholder="192.168.1.10", id="inp-host")
+
+                yield Label("Port", classes="field-label")
+                yield Input(value=str(s.port) if editing else "22", placeholder="22", id="inp-port")
+
+                yield Label("User", classes="field-label")
+                yield Input(value=s.user if editing else "root", placeholder="root", id="inp-user")
+
+                yield Label("Group (optional)", classes="field-label")
+                yield Input(value=s.group if editing else "", placeholder="production", id="inp-group")
+
+                yield Label("Password", classes="field-label")
+                yield Input(value=self._password, placeholder="Leave empty for key auth", password=True, id="inp-pass")
+
+                yield Label("SSH Key Path (optional)", classes="field-label")
+                yield Input(value=s.identity_file if editing else "", placeholder="~/.ssh/id_rsa", id="inp-key")
+
+                yield Checkbox("Auto sudo (elevate to root)", s.sudo if editing else False, id="inp-sudo")
+
+            yield Static(
+                f"[bold {C_GREEN_BRIGHT}]ctrl+s[/] save  "
+                f"[{C_GREEN_DARK}]|[/]  "
+                f"[bold {C_GREEN_BRIGHT}]esc[/] cancel",
+                id="form-hints",
+            )
+
+    def action_save(self) -> None:
+        name = self.query_one("#inp-name", Input).value.strip()
+        host = self.query_one("#inp-host", Input).value.strip()
+        port_s = self.query_one("#inp-port", Input).value.strip()
+        user = self.query_one("#inp-user", Input).value.strip() or "root"
+        group = self.query_one("#inp-group", Input).value.strip()
+        password = self.query_one("#inp-pass", Input).value
+        key = self.query_one("#inp-key", Input).value.strip()
+        sudo = self.query_one("#inp-sudo", Checkbox).value
+
+        if not name or not host:
+            self.notify("Name and Host are required.", severity="error")
+            return
+        try:
+            port = int(port_s) if port_s else 22
+        except ValueError:
+            self.notify("Port must be a number.", severity="error")
+            return
+
+        if self.server:
+            self.server.name = name
+            self.server.host = host
+            self.server.port = port
+            self.server.user = user
+            self.server.group = group
+            self.server.identity_file = key
+            self.server.sudo = sudo
+            server = self.server
+        else:
+            server = Server(name=name, host=host, port=port, user=user, group=group, identity_file=key, sudo=sudo)
+
+        self.app.storage.set_password(server.id, password)
+        self.dismiss(server)
+
+    def action_cancel(self) -> None:
+        self.dismiss(None)
+
+
+class ConfirmDelete(ModalScreen[bool]):
+    """Confirmation dialog for server deletion."""
+
+    CSS = f"""
+    ConfirmDelete {{
+        align: center middle;
+        background: {C_BG} 80%;
+    }}
+    #del-box {{
+        width: 50;
+        height: auto;
+        border: solid {C_RED};
+        background: {C_BG};
+        padding: 1 2;
+    }}
+    #del-msg {{
+        text-align: center;
+        width: 100%;
+        margin: 1 0;
+        color: {C_RED};
+    }}
+    #del-hints {{
+        text-align: center;
+        width: 100%;
+        margin-top: 1;
+        color: {C_GREEN_DIM};
+    }}
+    """
+
+    BINDINGS = [
+        Binding("y", "confirm", "Yes", show=False),
+        Binding("enter", "confirm", "Confirm", show=False),
+        Binding("n", "deny", "No", show=False),
+        Binding("escape", "deny", "Cancel", show=False),
+    ]
+
+    def __init__(self, server_name: str):
+        super().__init__()
+        self.server_name = server_name
+
+    def compose(self) -> ComposeResult:
+        with Vertical(id="del-box"):
+            yield Static(
+                f"[bold {C_RED}]// WARNING[/]\n"
+                f"[{C_RED}]Delete '[bold]{self.server_name}[/bold]' ?[/]",
+                id="del-msg",
+            )
+            yield Static(
+                f"[bold {C_GREEN_BRIGHT}]y[/] / [bold {C_GREEN_BRIGHT}]enter[/] confirm  "
+                f"[{C_GREEN_DARK}]|[/]  "
+                f"[bold {C_GREEN_BRIGHT}]n[/] / [bold {C_GREEN_BRIGHT}]esc[/] cancel",
+                id="del-hints",
+            )
+
+    def action_confirm(self) -> None:
+        self.dismiss(True)
+
+    def action_deny(self) -> None:
+        self.dismiss(False)
+
+
+# ---------------------------------------------------------------------------
+# Main App
+# ---------------------------------------------------------------------------
+
+class SSHManagerApp(App):
+    """Terminal SSH connection manager."""
+
+    TITLE = "SSHM"
+
+    CSS = f"""
+    Screen {{
+        background: {C_BG};
+    }}
+
+    /* ---- Banner ---- */
+    #banner {{
+        dock: top;
+        width: 100%;
+        height: 3;
+        background: {C_SURFACE};
+        content-align: center middle;
+        border-bottom: solid {C_GREEN_DARK};
+    }}
+
+    /* ---- Search ---- */
+    #search-bar {{
+        dock: top;
+        height: 3;
+        display: none;
+        padding: 0 1;
+        background: {C_SURFACE};
+    }}
+    #search-bar.visible {{
+        display: block;
+    }}
+    #search-input {{
+        background: {C_BG};
+        color: {C_GREEN_BRIGHT};
+        border: tall {C_GREEN_DARK};
+    }}
+    #search-input:focus {{
+        border: tall {C_GREEN_BRIGHT};
+    }}
+
+    /* ---- Server table ---- */
+    DataTable {{
+        height: 1fr;
+        background: {C_BG};
+        color: {C_GREEN_MID};
+    }}
+    DataTable > .datatable--cursor {{
+        background: {C_GREEN_DIM};
+        color: {C_BG};
+        text-style: bold;
+    }}
+    DataTable > .datatable--header {{
+        background: {C_SURFACE};
+        color: {C_GREEN_BRIGHT};
+        text-style: bold;
+    }}
+    DataTable > .datatable--even-row {{
+        background: {C_BG};
+    }}
+    DataTable > .datatable--odd-row {{
+        background: {C_PANEL};
+    }}
+
+    /* ---- Empty state ---- */
+    #empty-hint {{
+        width: 100%;
+        height: 100%;
+        content-align: center middle;
+        color: {C_GREEN_MUTED};
+    }}
+    #empty-hint.hidden {{
+        display: none;
+    }}
+
+    /* ---- Footer ---- */
+    Footer {{
+        background: {C_SURFACE};
+    }}
+    Footer > .footer--key {{
+        background: {C_GREEN_DARK};
+        color: {C_GREEN_BRIGHT};
+    }}
+    Footer > .footer--description {{
+        color: {C_GREEN_DIM};
+    }}
+    FooterKey > .footer--key {{
+        background: {C_GREEN_DARK};
+        color: {C_GREEN_BRIGHT};
+    }}
+    FooterKey > .footer--description {{
+        color: {C_GREEN_DIM};
+    }}
+    """
+
+    BINDINGS = [
+        Binding("a", "add_server", "Add"),
+        Binding("e", "edit_server", "Edit"),
+        Binding("d", "delete_server", "Delete"),
+        Binding("c", "copy_cmd", "Copy SSH"),
+        Binding("slash", "toggle_search", "Search"),
+        Binding("escape", "esc_pressed", "Quit", show=False),
+        Binding("q", "quit", "Quit"),
+    ]
+
+    def __init__(self):
+        super().__init__()
+        self.storage = Storage()
+        self._filter = ""
+        self._visible: list[Server] = []
+
+    def compose(self) -> ComposeResult:
+        yield Static(
+            f"[bold {C_GREEN_BRIGHT}]>_[/] "
+            f"[bold {C_GREEN_BRIGHT}]SSHM[/] "
+            f"[{C_GREEN_DARK}]::[/] "
+            f"[{C_GREEN_DIM}]SSH Connection Manager[/]",
+            id="banner",
+        )
+        with Vertical(id="search-bar"):
+            yield Input(placeholder="// filter servers ...", id="search-input")
+        yield DataTable(id="server-table")
+        yield Static(
+            f"[{C_GREEN_MUTED}]> No servers in the matrix. "
+            f"Press [{C_GREEN_BRIGHT}]a[/{C_GREEN_BRIGHT}] to add one.[/]",
+            id="empty-hint",
+        )
+        yield Footer()
+
+    def on_mount(self) -> None:
+        table = self.query_one(DataTable)
+        table.add_columns("Name", "Host", "User", "Port", "Group")
+        table.cursor_type = "row"
+        table.zebra_stripes = True
+        self._refresh_table()
+
+    # --- table helpers ---
+
+    def _refresh_table(self) -> None:
+        table = self.query_one(DataTable)
+        table.clear()
+
+        servers = self.storage.servers
+        if self._filter:
+            ft = self._filter.lower()
+            servers = [
+                s for s in servers
+                if ft in s.name.lower()
+                or ft in s.host.lower()
+                or ft in s.user.lower()
+                or ft in s.group.lower()
+            ]
+
+        self._visible = list(servers)
+        for s in servers:
+            table.add_row(s.name, s.host, s.user, str(s.port), s.group or "-", key=s.id)
+
+        hint = self.query_one("#empty-hint")
+        if servers:
+            hint.add_class("hidden")
+        else:
+            hint.remove_class("hidden")
+
+    def _selected_server(self) -> Server | None:
+        table = self.query_one(DataTable)
+        if table.row_count == 0:
+            return None
+        idx = table.cursor_coordinate.row
+        if 0 <= idx < len(self._visible):
+            return self._visible[idx]
+        return None
+
+    # --- actions ---
+
+    def action_add_server(self) -> None:
+        def on_result(server: Server | None) -> None:
+            if server:
+                self.storage.add_server(server)
+                self._refresh_table()
+                self.notify(f"Added '{server.name}'")
+
+        self.push_screen(ServerForm(), callback=on_result)
+
+    def action_edit_server(self) -> None:
+        server = self._selected_server()
+        if not server:
+            self.notify("No server selected", severity="warning")
+            return
+        password = self.storage.get_password(server.id)
+
+        def on_result(updated: Server | None) -> None:
+            if updated:
+                self.storage.update_server(updated)
+                self._refresh_table()
+                self.notify(f"Updated '{updated.name}'")
+
+        self.push_screen(ServerForm(server=server, password=password), callback=on_result)
+
+    def action_delete_server(self) -> None:
+        server = self._selected_server()
+        if not server:
+            self.notify("No server selected", severity="warning")
+            return
+
+        def on_confirm(confirmed: bool) -> None:
+            if confirmed:
+                self.storage.delete_server(server.id)
+                self._refresh_table()
+                self.notify(f"Deleted '{server.name}'")
+
+        self.push_screen(ConfirmDelete(server.name), callback=on_confirm)
+
+    def on_data_table_row_selected(self, event: DataTable.RowSelected) -> None:
+        """Connect on Enter / double-click."""
+        server_id = str(event.row_key.value)
+        server = self.storage.get_server(server_id)
+        if not server:
+            return
+        password = self.storage.get_password(server.id)
+        with self.suspend():
+            ssh_connect(server, password)
+
+    def action_copy_cmd(self) -> None:
+        server = self._selected_server()
+        if not server:
+            self.notify("No server selected", severity="warning")
+            return
+        parts = ["ssh"]
+        if server.identity_file:
+            parts += ["-i", server.identity_file]
+        parts += ["-p", str(server.port), f"{server.user}@{server.host}"]
+        cmd = " ".join(parts)
+        subprocess.run(["pbcopy"], input=cmd.encode(), check=False)
+        self.notify(f"Copied: {cmd}")
+
+    # --- search ---
+
+    def action_toggle_search(self) -> None:
+        bar = self.query_one("#search-bar")
+        if bar.has_class("visible"):
+            self._close_search()
+        else:
+            bar.add_class("visible")
+            self.query_one("#search-input", Input).focus()
+
+    def action_esc_pressed(self) -> None:
+        bar = self.query_one("#search-bar")
+        if bar.has_class("visible"):
+            self._close_search()
+        else:
+            self.exit()
+
+    def _close_search(self) -> None:
+        self.query_one("#search-bar").remove_class("visible")
+        self.query_one("#search-input", Input).value = ""
+        self._filter = ""
+        self._refresh_table()
+        self.query_one(DataTable).focus()
+
+    @on(Input.Changed, "#search-input")
+    def _on_search(self, event: Input.Changed) -> None:
+        self._filter = event.value
+        self._refresh_table()
+
+    @on(Input.Submitted, "#search-input")
+    def _on_search_submit(self) -> None:
+        self.query_one(DataTable).focus()
+
+
+def cmd_list():
+    """Print saved servers to stdout."""
+    storage = Storage()
+    if not storage.servers:
+        print(f"\033[32m> No servers saved. Run `sshm` to add one.\033[0m")
+        return
+    rows = [(s.name, s.host, s.user, str(s.port), s.group or "-") for s in storage.servers]
+    headers = ("NAME", "HOST", "USER", "PORT", "GROUP")
+    widths = [max(len(h), *(len(r[i]) for r in rows)) for i, h in enumerate(headers)]
+    fmt = "  ".join(f"{{:<{w}}}" for w in widths)
+    print(f"\033[1;32m{fmt.format(*headers)}\033[0m")
+    print(f"\033[32m{fmt.format(*('─' * w for w in widths))}\033[0m")
+    for r in rows:
+        print(f"\033[32m{fmt.format(*r)}\033[0m")
+
+
+def main():
+    import sys
+
+    if len(sys.argv) > 1:
+        cmd = sys.argv[1]
+        if cmd == "list":
+            cmd_list()
+        elif cmd == "help":
+            print("\033[1;32m> SSHM\033[0m \033[32m:: SSH Connection Manager\033[0m")
+            print()
+            print("\033[32mUsage: sshm [command]\033[0m")
+            print()
+            print("\033[32m  (none)    Open the TUI manager\033[0m")
+            print("\033[32m  list      List saved servers\033[0m")
+            print("\033[32m  help      Show this help\033[0m")
+        else:
+            print(f"\033[31mUnknown command: {cmd}\033[0m")
+            print("\033[32mRun `sshm help` for usage.\033[0m")
+            sys.exit(1)
+        return
+
+    app = SSHManagerApp()
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

sshm_terminal-1.0.0/sshm/storage.py

@@ -0,0 +1,114 @@
+"""Server storage with JSON persistence and macOS Keychain for passwords."""
+
+import json
+import subprocess
+import uuid
+from dataclasses import asdict, dataclass, field
+from pathlib import Path
+
+DATA_DIR = Path.home() / ".sshm"
+SERVERS_FILE = DATA_DIR / "servers.json"
+KEYCHAIN_SERVICE = "sshm"
+
+
+@dataclass
+class Server:
+    name: str
+    host: str
+    user: str = "root"
+    port: int = 22
+    group: str = ""
+    identity_file: str = ""
+    sudo: bool = False
+    id: str = field(default_factory=lambda: uuid.uuid4().hex[:8])
+
+    def to_dict(self) -> dict:
+        return asdict(self)
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Server":
+        known = {f for f in cls.__dataclass_fields__}
+        return cls(**{k: v for k, v in data.items() if k in known})
+
+
+class Storage:
+    def __init__(self):
+        DATA_DIR.mkdir(exist_ok=True)
+        self.servers: list[Server] = []
+        self.load()
+
+    def load(self):
+        if SERVERS_FILE.exists():
+            data = json.loads(SERVERS_FILE.read_text())
+            self.servers = [Server.from_dict(s) for s in data]
+        else:
+            self.servers = []
+
+    def save(self):
+        data = [s.to_dict() for s in self.servers]
+        SERVERS_FILE.write_text(json.dumps(data, indent=2))
+
+    def add_server(self, server: Server):
+        self.servers.append(server)
+        self.save()
+
+    def update_server(self, server: Server):
+        for i, s in enumerate(self.servers):
+            if s.id == server.id:
+                self.servers[i] = server
+                break
+        self.save()
+
+    def delete_server(self, server_id: str):
+        self.servers = [s for s in self.servers if s.id != server_id]
+        self.save()
+        self.delete_password(server_id)
+
+    def get_server(self, server_id: str) -> Server | None:
+        for s in self.servers:
+            if s.id == server_id:
+                return s
+        return None
+
+    # --- macOS Keychain via `security` CLI ---
+
+    def get_password(self, server_id: str) -> str:
+        try:
+            result = subprocess.run(
+                [
+                    "security", "find-generic-password",
+                    "-a", KEYCHAIN_SERVICE,
+                    "-s", server_id,
+                    "-w",
+                ],
+                capture_output=True,
+                text=True,
+            )
+            if result.returncode == 0:
+                return result.stdout.strip()
+        except Exception:
+            pass
+        return ""
+
+    def set_password(self, server_id: str, password: str):
+        self.delete_password(server_id)
+        if password:
+            subprocess.run(
+                [
+                    "security", "add-generic-password",
+                    "-a", KEYCHAIN_SERVICE,
+                    "-s", server_id,
+                    "-w", password,
+                ],
+                capture_output=True,
+            )
+
+    def delete_password(self, server_id: str):
+        subprocess.run(
+            [
+                "security", "delete-generic-password",
+                "-a", KEYCHAIN_SERVICE,
+                "-s", server_id,
+            ],
+            capture_output=True,
+        )