awstui

README

awstui

A terminal user interface (TUI) for interacting with AWS services, built with Go and Bubble Tea.

DISCLAIMER: This was my first attempt at "vibe coding". I wanted to see if it was as good/bad people are claiming it to be. I made some manually tweaks a well.

Features

• Navigate and manage AWS resources (e.g., EC2, ECS, ECR).
• Interactive and responsive TUI experience.
• Lightweight and fast.

EC2

• List instances
• View details
• Start instance
• Stop instance
• SSH into instance

ECS

• List clusters
• List services
• View service details
• View Logs
• Trigger service redeployment
• Stop service (scale to 0)
• Scale service

ECR

• View private repositories
• View images
• Pull image
• Push image

Step Functions

• View
• Start New Execution
• View Executions
• View Execution Steps

Batch

• View Queues
• View Batch Jobs
• View Batch Job Logs
• Execute Batch Jobs

Installation

To install awstui, make sure you have Go installed (version 1.16 or higher is recommended).

go install github.com/theoreticallyjosh/awstui@latest

Configuration

Default path for the global config file:

• Linux: ~/.config/awstui/config.yml
• MacOS: ~/Library/Application\ Support/awstui/config.yml
• Windows: %LOCALAPPDATA%\awstui\config.yml

AWS

To use awstui, you will need to configure your AWS credentials. You can follow the same steps required of aws-cli.

Theme

You can set the color theme in the awstui config.yml file:

theme: <bubble_tint_id>

A list of available themes/tints can be found here.

Usage

After installation, you can run awstui from your terminal:

awstui

Screenshots

Contributing

Contributions are welcome! Please feel free to open issues or submit pull requests.

License

This project is licensed under the MIT License.