Interactive CLI to connect to AWS EC2 instances via:
SSM Session Manager (shell)
SSH over SSM (with your SSH key)
Multiple sessions in parallel (opens each in a new terminal)
Keyword search across Name/ID/all tag values
Simple, cross-platform, and secure by default.
Features
Search instances by keywords (matches Name, InstanceId, and all tag values)
Choose SSM or SSH-over-SSM per connection
Optional strict SSH host key checking (security toggle)
Opens each session in a new terminal window (Linux, macOS, Windows)
Uses your existing AWS credentials (SSO, profiles, env vars)
Validates SSH key path and permissions (Unix)
Requirements
AWS account permissions to use SSM Session Manager
Locally installed:
AWS CLI v2
SSM Session Manager plugin
OpenSSH client (ssh)
Python 3.8+
boto3 (installed automatically if using PyPI package)
On Linux/macOS, ensure a terminal emulator exists (e.g., gnome-terminal, xterm, or Terminal.app on macOS). On Windows, PowerShell or Windows Terminal recommended.
Install
From source:
Clone this repo and run the script with Python 3.
From PyPI (if published):
pip install ssm-connect
ssm-connect
Usage
Run the tool
Optionally enter keywords to filter instances (e.g., “prod web”)
Select an instance
Choose connection type:
SSM (interactive shell)
SSH over SSM (enter SSH key path and user)
For SSH, choose whether to enable strict host key checking
Each session opens in a new terminal; you can open more without restarting the tool
Notes
SSH over SSM uses AWS-StartSSHSession and does not require port 22 open in security groups.
Strict host key checking is disabled by default for convenience; enable it for production/security-sensitive use.
The tool does not print or store credentials; it inherits your AWS session from the environment/AWS CLI.
Troubleshooting
If “aws” or “ssh” not found: ensure AWS CLI v2 and OpenSSH are on PATH.
If SSO token expired: run aws sso login or refresh your Granted/SSO session.
If SSH key error: ensure the private key exists locally and has correct permissions (chmod 600 on Unix). Avoid cloud-only paths (e.g., OneDrive placeholders).
License
Apache License 2.0. See LICENSE for details.
Contributing
Issues and PRs are welcome. Please keep changes focused and add brief notes to the README when behavior changes.
Raw data
{
"_id": null,
"home_page": null,
"name": "ssm-connect",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "aws, ec2, ssm, ssh, cli, session-manager, devops, cloud, sre, operations, infrastructure",
"author": null,
"author_email": "Siby Jose <jose.siby@icloud.com>",
"download_url": "https://files.pythonhosted.org/packages/04/fc/19ff3e128cedb72ecfc85fccad8841583015e8db68d5788fef59d6cf5dee/ssm_connect-1.0.3.tar.gz",
"platform": null,
"description": "Interactive CLI to connect to AWS EC2 instances via:\r\n\r\nSSM Session Manager (shell)\r\n\r\nSSH over SSM (with your SSH key)\r\n\r\nMultiple sessions in parallel (opens each in a new terminal)\r\n\r\nKeyword search across Name/ID/all tag values\r\n\r\nSimple, cross-platform, and secure by default.\r\n\r\nFeatures\r\nSearch instances by keywords (matches Name, InstanceId, and all tag values)\r\n\r\nChoose SSM or SSH-over-SSM per connection\r\n\r\nOptional strict SSH host key checking (security toggle)\r\n\r\nOpens each session in a new terminal window (Linux, macOS, Windows)\r\n\r\nUses your existing AWS credentials (SSO, profiles, env vars)\r\n\r\nValidates SSH key path and permissions (Unix)\r\n\r\nRequirements\r\nAWS account permissions to use SSM Session Manager\r\n\r\nLocally installed:\r\n\r\nAWS CLI v2\r\n\r\nSSM Session Manager plugin\r\n\r\nOpenSSH client (ssh)\r\n\r\nPython 3.8+\r\n\r\nboto3 (installed automatically if using PyPI package)\r\n\r\nOn Linux/macOS, ensure a terminal emulator exists (e.g., gnome-terminal, xterm, or Terminal.app on macOS). On Windows, PowerShell or Windows Terminal recommended.\r\n\r\nInstall\r\nFrom source:\r\n\r\nClone this repo and run the script with Python 3.\r\n\r\nFrom PyPI (if published):\r\n\r\npip install ssm-connect\r\n\r\nssm-connect\r\n\r\nUsage\r\nRun the tool\r\n\r\nOptionally enter keywords to filter instances (e.g., \u201cprod web\u201d)\r\n\r\nSelect an instance\r\n\r\nChoose connection type:\r\n\r\nSSM (interactive shell)\r\n\r\nSSH over SSM (enter SSH key path and user)\r\n\r\nFor SSH, choose whether to enable strict host key checking\r\n\r\nEach session opens in a new terminal; you can open more without restarting the tool\r\n\r\nNotes\r\nSSH over SSM uses AWS-StartSSHSession and does not require port 22 open in security groups.\r\n\r\nStrict host key checking is disabled by default for convenience; enable it for production/security-sensitive use.\r\n\r\nThe tool does not print or store credentials; it inherits your AWS session from the environment/AWS CLI.\r\n\r\nTroubleshooting\r\nIf \u201caws\u201d or \u201cssh\u201d not found: ensure AWS CLI v2 and OpenSSH are on PATH.\r\n\r\nIf SSO token expired: run aws sso login or refresh your Granted/SSO session.\r\n\r\nIf SSH key error: ensure the private key exists locally and has correct permissions (chmod 600 on Unix). Avoid cloud-only paths (e.g., OneDrive placeholders).\r\n\r\nLicense\r\nApache License 2.0. See LICENSE for details.\r\n\r\nContributing\r\nIssues and PRs are welcome. Please keep changes focused and add brief notes to the README when behavior changes.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Interactive CLI to connect to AWS EC2 via SSM or SSH-over-SSM, with keyword search and multi-session terminal launch.",
"version": "1.0.3",
"project_urls": null,
"split_keywords": [
"aws",
" ec2",
" ssm",
" ssh",
" cli",
" session-manager",
" devops",
" cloud",
" sre",
" operations",
" infrastructure"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "aa50ee9c4a478919347de2b3826004eff5a7aeaff18a50ca69a625e58ef12dcc",
"md5": "8cee2ddc98f992e292776be048ecc17e",
"sha256": "c89d3c149ab6fb103be2bead22ecb53a86f598e5e0733f3e180838e4d5803acd"
},
"downloads": -1,
"filename": "ssm_connect-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8cee2ddc98f992e292776be048ecc17e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 11379,
"upload_time": "2025-10-06T16:32:22",
"upload_time_iso_8601": "2025-10-06T16:32:22.593814Z",
"url": "https://files.pythonhosted.org/packages/aa/50/ee9c4a478919347de2b3826004eff5a7aeaff18a50ca69a625e58ef12dcc/ssm_connect-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "04fc19ff3e128cedb72ecfc85fccad8841583015e8db68d5788fef59d6cf5dee",
"md5": "2ee113bd811dd6c17312ea3d3e6f9ec4",
"sha256": "d129be35e53501315766746c149d62cc252ca812954fab60c55fc0e31ea71b71"
},
"downloads": -1,
"filename": "ssm_connect-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "2ee113bd811dd6c17312ea3d3e6f9ec4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 11882,
"upload_time": "2025-10-06T16:32:23",
"upload_time_iso_8601": "2025-10-06T16:32:23.620803Z",
"url": "https://files.pythonhosted.org/packages/04/fc/19ff3e128cedb72ecfc85fccad8841583015e8db68d5788fef59d6cf5dee/ssm_connect-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-06 16:32:23",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "ssm-connect"
}
JSON