awstui 0.8.72

A read-only TUI for browsing AWS resources

awstui

A read-only terminal UI for browsing AWS resources, built with Textual and boto3.

Features

• Browse AWS resources in a tree-based navigation pane
• View tags for selected resources
• View tag summary for collections of resources
• View resource details in a Summary or Raw JSON tab
• Switch regions on the fly
• Pluggable service architecture — easy to add new AWS services
• Graceful handling of permission errors

Screenshots

Supported Services

S3, Lambda, RDS, IAM, SQS, SNS, Secrets Manager, ECR

Installation

Requires Python 3.12+ and uv.

uv sync

Usage

uv run awstui
uv run awstui --profile my-profile       # use a specific AWS profile

Uses your existing AWS credentials (environment variables, ~/.aws/credentials, SSO — whatever boto3 resolves). Pass --profile/-p to override the profile explicitly.

Hotkeys

Key	Action
1	Focus the region selector
2	Focus the navigation tree
3	Focus the detail pane
a	Copy the ARN of the selected resource to the clipboard
u	Copy the URI of the selected resource (S3 bucket/object, ECR image)
r	Copy the Raw JSON of the selected resource to the clipboard
f	Filter children of the highlighted node by substring (empty input clears)

Running Tests

uv run pytest tests/ -v