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

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: awstui-0.4.60.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.4.60.tar.gz
Algorithm Hash digest
SHA256 4492bf30094d005485b9c976747c446f6dc5d17f803a39a4f5e971a677bbb9b0
MD5 53028ba4da5d811e96f45d2e3a827239
BLAKE2b-256 81da0c47a0da8aa5ce29af91c4c68a8d2338418340cc748fdf37769e5cd10f22

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: awstui-0.4.60-py3-none-any.whl
  • Upload date:
  • Size: 26.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.4.60-py3-none-any.whl
Algorithm Hash digest
SHA256 394c2ca5da97190edea2bbf5e413acd95d427a89d1e09d6c2ceb2203a7a3d583
MD5 210be3c4000c016d1336ed694fb05733
BLAKE2b-256 29b3de129d4b77b99a7e8a9aea57349b35514943d05841e6ab660a76421ac137

See more details on using hashes here.

Provenance

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