README.md

awssh

Description

awssh is a simple CLI providing an ssh access to EC2 utilizing an EC2 Instance Connect feature.
The awssh is extending the aws ec2-instance-connect command to be aware with ssh-agent and/or populate new temporary ssh keypair while trying to establish an ssh connection to the EC2 instance target.

Diagram Flow

<user>
    |
<AWS credentials>
    |
<Get list of ec2 instances>
    |
<Create temporary ssh keypair>
    or
<Use existing ssh keypair within ssh-agent>
    |
<Send ssh public key>
    |
<Establish an ssh connection>

Development Guide

Prerequisites

• Go 1.16 or later

Setup

• Install Git
• Install Go 1.16 or later
• Clone this repository

Build and run binary file

To build binary file: make build

Installation Guide

Check the release page. Please read user guide for further use.