awstui 0.21.113

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
• Filter hotkey
• Copy URI hotkey (for S3 buckets and objects, ECR images)
• Copy ARN hotkey
• Size hotkey — calculate the total size of an S3 bucket, folder, or object on demand (recursive, with a live-updating total)

Screenshots

Supported Services

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

Installation

Requires Python 3.12+ and uv.

uv sync

Usage

uv run awstui
uv run awstui --profile my-profile              # use a specific AWS profile
uv run awstui --service s3 --service lambda     # only show these services

Uses your existing AWS credentials (environment variables, ~/.aws/credentials, SSO — whatever boto3 resolves). Pass --profile/-p to override the profile explicitly. Pass --service/-s one or more times to restrict which services appear in the navigation tree; omit it to show all services.

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
s	Toggle size calculation for the highlighted S3 bucket/folder/object (recursive total shown in the node label; expanding a sized node sizes its children too). Counts current object versions only — noncurrent versions are excluded, so on versioned buckets the total can be smaller than the actual stored footprint. Not available on individual version nodes.
f	Filter children of the highlighted node by substring (empty input clears)
w	Toggle word wrap in the Content tab (CSVs default to no-wrap, others to wrap)

Running Tests

uv run pytest tests/ -v