Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

AWS Remote

AWS Remote is a command line tool to view and interact with AWS instances via SSM

Depends On:

What Can It Do?

aws-remote will list all your EC2 instances in the specified account/region, and display helpful information like state and SSM management status. aws-remote is also a wrapper for the AWS CLI that makes starting remote sessions and port-forwarding easier. Remote sessions and port-forwarding can be started using the EC2 Instance ID or the friendly name.


$ aws-remote --help
Usage: aws-remote [OPTIONS] COMMAND [ARGS]...

  AWS Remote is a simple, command line tool to view and interact with AWS
  instances via SSM. Requires the AWS CLI and Session Manager Plugin to be
  installed locally.

  --profile TEXT  Specify AWS profile
  --region TEXT   Specify AWS region
  --help          Show this message and exit.

  list          List EC2 instances and SSM management status
  port-forward  Start SSM port forward to instance id/name
  session       Start SSM session with instance id/name

$ aws-remote list
ID                     AZ            Type         State      SSM     Name         
i-01234567890987654    us-east-1a    r4.xlarge    running    true
i-02345678909876543    us-east-1b    t3.micro     running    false       
i-03456789098765432    us-east-1c    t3.medium    running    true

$ aws-remote --profile my_profile session i-02345678909876543

$ aws-remote --profile my_profile session

$ aws-remote --profile my_profile --region us-west-2 port-forward 8080 80

Installation Steps:

  1. Verify Python3.6 or later is installed: python --version or python3 --version

  2. Verify AWS CLI version 1.16.12 or later is installed: aws --version

  3. Verify Session Manager plugin is installed: session-manager-plugin

  4. Clone repo to your computer: git clone

  5. Install script packages: pip install -r aws-remote/requirements.txt

  6. Verify script works: python3 aws-remote/aws-remote --help

  7. If desired, add alias to bash_profile and then restart terminal:

vi ~/.bash_profile
alias aws-remote='python3 ~/your-script-directory/aws-remote/aws-remote'