AWS Session Manager Plugin
Amazon Web Services · AWS CLI plugin for authorized shell, SSH transport, and port-forwarding sessions to Systems Manager managed nodes, without a separate desktop application.
brew install --cask session-manager-plugin- 30-day installs
- 14,585
- #29 in App
- 1-year installs
- 119.1K
- Last 365 days
- Latest version
- 1.2.896.0
- Download size
- 10MB
- pkg
- Release cadence
- Monthly
- 0 releases in 30 days
About
The Session Manager plugin lets the AWS CLI start interactive shell, SSH transport, and port-forwarding sessions to AWS Systems Manager managed nodes. It is a local command-line component for cloud administrators, developers, and operations teams, not the SSM Agent installed on remote nodes or a standalone desktop app.
Features
- Start and end sessions through AWS CLI commands and IAM authorization.
- Access managed nodes without opening inbound SSH ports for ordinary Session Manager shell sessions.
- Forward ports to managed nodes or reachable remote hosts using supported session documents.
- Use configured session shell profiles and AWS logging options where the session type supports them.
- Use SSH-style shell escape sequences in version 1.2.835.0, including ~. to terminate and ~? for help.
macOS installation and first use
Install brew install --cask session-manager-plugin. The cask installs the official architecture-specific signed PKG under /usr/local/sessionmanagerplugin and links its executable into the Homebrew bin directory. Administrative approval can be required. Check session-manager-plugin --version and your AWS CLI configuration, then start an authorized session with aws ssm start-session --target i-EXAMPLE. Replace the example with a real managed-node ID and choose the correct region/profile. These are instructions, not claims that a session has been tested on your account.
Dependencies and remote prerequisites
AWS documents AWS CLI 1.16.12 or later as the local minimum; use a currently supported CLI release. You need AWS credentials with appropriate IAM permissions. Remote nodes need SSM Agent, an appropriate instance role or hybrid activation configuration, and outbound connectivity to the required Systems Manager endpoints. The base session prerequisite is SSM Agent 2.3.68.0 or later; port forwarding and other features can require newer agent versions. A local plugin does not turn an unmanaged machine into a managed node. SSH-over-Session-Manager additionally requires the usual SSH client/server and authentication setup.
The signed PKG used by Homebrew differs from AWS's alternative ZIP bundle. AWS documents Python 3.10 or later for the ZIP installer script; do not treat that script requirement as an extra Homebrew runtime dependency. Go and build tools in the source README are for building from source. Homebrew declares no extra formula dependency, explicit macOS minimum, or package conflict. Existing manual installations or PATH links can collide with the cask's executable location; check the selected binary before reinstalling.
Platform support
AWS provides native packages for macOS Intel and Apple Silicon and separate Windows and Linux installers. This Homebrew cask installs only the Mac package. AWS's referenced installation guide does not specify a universal numeric minimum macOS version, so no unsupported minimum is asserted here. Managed-node operating-system support is a separate Systems Manager requirement and is not the same as the plugin's local host support. This is not an iOS or Android application. AWS currently requires plugin 1.2.764.0 or later for supported operations; the listed 1.2.835.0 exceeds that minimum.
Accounts, costs, and license
The plugin is open source under Apache License 2.0 and has no separate plugin subscription. Operational use requires an AWS account or authorized access to one. EC2 resources, hybrid/advanced management, logging, storage, network services, and other optional AWS capabilities can incur charges; installing a free plugin does not make the surrounding cloud resources free. Consult AWS's current pricing for the intended configuration. Ordinary shell session logging can be configured, but SSH and port-forwarded content have different logging limitations.
Official references
At a glance
- Chip
- Apple silicon · Intel
- Auto-updates
- No
- Repository
- Open source · Apache-2.0 · Updated 43 days ago★327
- Developer
- Amazon Web Services
- Homebrew
- Available; updated by Homebrew
- Also known as
- Session Manager Plugin for the AWS CLI, session-manager-plugin
- Homepage
- docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html
- Token
- session-manager-plugin
Checked
What’s new in 1.2.896.0
New OpenNavo editorial
Reverts the change titled “Session failure reason check and avoid hanging session.”
How to install AWS Session Manager Plugin on Mac
Homebrew runs the session-manager-plugin.pkg installer, which asks for an administrator password.
Install without Homebrew
Download the file Homebrew uses for your chip: Install Details
Uninstall AWS Session Manager Plugin and optional data cleanup
brew uninstall --cask session-manager-pluginA regular uninstall removes the app and keeps its settings and caches.
Deep clean (optional)
brew uninstall --zap --cask session-manager-plugin--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap.
Questions about AWS Session Manager Plugin
Is AWS Session Manager Plugin safe?
AWS Session Manager Plugin is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from session-manager-downloads.s3.amazonaws.com against its SHA-256 checksum. It was installed 14,585 times through Homebrew in the last 30 days.
Is AWS Session Manager Plugin open source?
AWS Session Manager Plugin’s source code is public on GitHub (aws/session-manager-plugin) under the Apache-2.0 license.
How do I completely uninstall AWS Session Manager Plugin on a Mac?
Run brew uninstall --cask session-manager-plugin. It forgets 1 installer receipt. To delete its settings and caches as well, run brew uninstall --zap --cask session-manager-plugin. --zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap. That also deletes /.
Does AWS Session Manager Plugin run on Apple silicon (M1 and later) Macs?
Yes. Homebrew downloads separate builds for Apple silicon and Intel Macs.
What is the latest version of AWS Session Manager Plugin?
The latest version is 1.2.896.0, added to Homebrew on Oct 21, 2026. Run brew upgrade --cask session-manager-plugin to update it.
What else does installing AWS Session Manager Plugin add?
It also adds 1 command-line tool: session-manager-plugin. It installs through a .pkg installer, which asks for an administrator password.
Similar Apps
- ZedFast native code editor with language tooling, Git, terminal, collaboration, remote development and optional AI agents on macOS, Linux and Windows.
- Android StudioGoogle’s official Android IDE with Kotlin and Java editing, Gradle builds, Compose previews, SDK and device management, debugging, and optional AI assistance.
- Google Antigravity CLIGoogle’s terminal coding agent for code exploration, multi-file changes, custom agents and connected tools, with interactive and remote workflows.
- Flutter SDKOpen-source Dart toolkit for building Android, iOS, web, and desktop applications with reusable widgets, hot reload, and integrated development tools.