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

Uploaded Python 3

File details

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

File metadata

  • Download URL: awstui-0.3.57.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.3.57.tar.gz
Algorithm Hash digest
SHA256 31bbbb841d2cb6e45aef5019068a4e48216f3a299c1b6b001c2ac45d0ae00900
MD5 a1f5eff850186f2283614ccb1007ede7
BLAKE2b-256 3f2b995257fca5386222e748e06636716ba9805173ddd59cfea1173ff77c351a

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: awstui-0.3.57-py3-none-any.whl
  • Upload date:
  • Size: 26.6 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.3.57-py3-none-any.whl
Algorithm Hash digest
SHA256 4048e71e96e246b246edb6b1e5858afc3650f5a3fb31e9f08fedca0714218781
MD5 1ebc62fa1eacc09e26f82c21631e6b02
BLAKE2b-256 0b8d5045dc5189e80f954a0191b08445952e1d424ae90b38ea701a531f74e28d

See more details on using hashes here.

Provenance

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