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
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.5.62.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.5.62-py3-none-any.whl (28.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: awstui-0.5.62.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.5.62.tar.gz
Algorithm Hash digest
SHA256 f51e9863e0e679d17f701dfa155a7f5a4bba13b295df7da2f29569c5b3b2ad47
MD5 c816e81eac54b9f62a54316edae2d574
BLAKE2b-256 a141cd57c2920484187417a8d3d796f8147493b9fe6415891017ad4af208a3d6

See more details on using hashes here.

Provenance

The following attestation bundles were made for awstui-0.5.62.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.5.62-py3-none-any.whl.

File metadata

  • Download URL: awstui-0.5.62-py3-none-any.whl
  • Upload date:
  • Size: 28.4 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.5.62-py3-none-any.whl
Algorithm Hash digest
SHA256 82d545f2a531618fd96d8a236ddef15193bc74b006d15588e0ae181548349f05
MD5 f4f64e0b256132be63e301e248d6c362
BLAKE2b-256 eaf973cf193fcbe25bd28d2d76bf465c7e4e51d743a9c113f8dc380b02b32507

See more details on using hashes here.

Provenance

The following attestation bundles were made for awstui-0.5.62-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