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.26.tar.gz (555.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.26-py3-none-any.whl (22.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: awstui-0.1.26.tar.gz
  • Upload date:
  • Size: 555.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.26.tar.gz
Algorithm Hash digest
SHA256 47c3f1cf38893da9373143326d0139c4ae18da8acea50a4a03839af3857e40a3
MD5 a78eacdcf2482e8233bdf69f66356bcb
BLAKE2b-256 3907a38cf9ed35a2e507350378fe4aa845bd4748030cb9854da93917e9dab149

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: awstui-0.1.26-py3-none-any.whl
  • Upload date:
  • Size: 22.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.26-py3-none-any.whl
Algorithm Hash digest
SHA256 19202a6e588fac31f8069140fdff9a3580ae0abc3c8e00d02f88882f0aeeeaf2
MD5 06f05f0ac45802c90f069d0d32ed26bf
BLAKE2b-256 4a23bbe919a4b2022fcf40ed4ad92b836ee1da4f80f74ab776c7014545613b90

See more details on using hashes here.

Provenance

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