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 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

Screenshot

Screenshot

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
c 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.1.37.tar.gz (618.1 kB view details)

Uploaded Source

Built Distribution

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

awstui-0.1.37-py3-none-any.whl (24.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for awstui-0.1.37.tar.gz
Algorithm Hash digest
SHA256 eb8e4c15c2e25fe0a455b2728bfcd560101dd95db1a06269fd5cc065709ca8d4
MD5 d0f977dc54bda73309670b9ff74aaa3e
BLAKE2b-256 21a80f310d12acb91b2ff07d178103b331f3a3c454de230d56ff660e5e95d688

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: awstui-0.1.37-py3-none-any.whl
  • Upload date:
  • Size: 24.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.1.37-py3-none-any.whl
Algorithm Hash digest
SHA256 67caa340197b90101799186176b9c4055d1136e048d5b6d168a2d50ae60afc9b
MD5 c09cc6626e7b521b0760ca11ab3d453b
BLAKE2b-256 dc288669f00796884a6eaade62f871a2074e9793d3dcaf2525f56572f66ae1c2

See more details on using hashes here.

Provenance

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