lens: A Go repository from Anysphere

Cloudlens - k9s like CLI for AWS.

AWS Console in your terminal! well, almost. Explore AWS services like EC2, S3, IAM, VPC, etc. from your terminal. If you like k9s for Kubernetes, you'll love cloudlens.

Installation

Via Homebrew for macOS or Linux
```
brew install one2nc/cloudlens/cloudlens
```
Using go install cloudlens requires go1.19 to install successfully. Run the following command to install the latest version -
```
    go install -v github.com/anysphere/lens@latest
```
Building from source code Cloudlens is currently in active development. We use Go 1.19. Follow these steps to build cloudlens locally:
```
 1. Clone the repo
 2. Build and run the executable
```
To Run:
```
make run
```

Prerequisite

Docker installed on your local. Refer this documentation
If you want to use localstack for populating dummy data, use our repo cloud-lens-populator

Usage

For the simple usage, just run the command without any options.

cloudlens

For knowing all the options available, use:

cloudlens help

Self Update

For updating to latest version, use:

cloudlens update

Features

Cloudlens supports viewing EC2 instances, S3 buckets, EBS volumes, VPCs, SQS queues, Lambda functions, Subnets, Security Groups, and IAM roles. Read the cloudlens documentation to know more.

Screenshots

EC2
EC2 Details
S3
S3 Details

Documentation

Please refer to our cloudlens documentation to know more.

Key Bindings

Cloudlens uses k9s like shortcuts for navigation. Listed below are few of the shortcuts:

Action	Command
Show active keyboard mnemonics and help	?
To bail out of cloudlens	:q , ctrl-c
Bails out of view/command/filter mode	esc
To view and switch to another AWS Service	:S3/EC2/VPC⏎

Note

Cloudlens reads your ~/.aws/config file, but it does not store or send your access and secret key anywhere. The access and secret key is used only to securely connect to AWS API via AWS SDK.

Since cloudlens is in readonly mode, we recommend you create an access and secret key that only has readonly permissions to the AWS services.

Acknowledgements

We would like to express our sincere appreciation to K9s as it has been a invaluable source of reference for this project.

All materials licensed under Apache v2.0

anysphere/lens