Skip to main content

A read-only TUI for browsing AWS resources

Project description

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

Start Tag summary

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

Running Tests

uv run pytest tests/ -v

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

awstui-0.7.67.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

awstui-0.7.67-py3-none-any.whl (28.8 kB view details)

Uploaded Python 3

File details

Details for the file awstui-0.7.67.tar.gz.

File metadata

  • Download URL: awstui-0.7.67.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for awstui-0.7.67.tar.gz
Algorithm Hash digest
SHA256 48df5effdfb40692b64f5597d43f07d3b9382aa06449b236c2b5a503f8d2081d
MD5 65196a74145ee6ed6ee7382c131034f1
BLAKE2b-256 3c1001f6953aedac8a8bb529277d59b03be06bcf275e71e604bfcd1cf526cfc9

See more details on using hashes here.

Provenance

The following attestation bundles were made for awstui-0.7.67.tar.gz:

Publisher: ci.yml on jamiekt/awstui

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file awstui-0.7.67-py3-none-any.whl.

File metadata

  • Download URL: awstui-0.7.67-py3-none-any.whl
  • Upload date:
  • Size: 28.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for awstui-0.7.67-py3-none-any.whl
Algorithm Hash digest
SHA256 5a37e22f3e3311cf94be66ab6c5cccd9f2cfc8ebac793c78c538586397ce8bd1
MD5 e6fdd54cd169c3ca4df961f52b125389
BLAKE2b-256 0c5a9f8a60129ba985b299f3756621a41ccdbf5bff3ed160ed66f2ffe04c9b04

See more details on using hashes here.

Provenance

The following attestation bundles were made for awstui-0.7.67-py3-none-any.whl:

Publisher: ci.yml on jamiekt/awstui

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page