Skip to content

aws-tui

A wireframe cloud of teal light anchored by golden tethers to a glowing point on a dark sea, the AWS-TUI wordmark seated at its luminous core.

aws-tui in demo mode with the S3, EMR, Glue, and Athena service rail; the Glue catalog is showing an Iceberg table, its metadata tabs, and snapshot history.

Python 3.11, 3.12, and 3.13 Runs on macOS, Linux, and Windows Built with Textual and the VMx MVVM framework Apache-2.0 licensed

Cross-platform TUI for AWS and S3-compatible services — runs on macOS, Linux, and Windows. Powered by Textual and the VMx MVVM framework.

aws-tui puts the AWS work that usually means switching between the web console and a shell behind a single keyboard-driven terminal interface: a Norton-Commander-style dual-pane file manager for S3 and S3-compatible storage, an EMR Serverless console, and read-only operations consoles for AWS Glue and Amazon Athena. What sets it apart is that those services are wired to each other rather than merely bundled together — a Glue catalog table generates the Athena SQL that reads it, Athena results hand back to the S3 pane as artifacts, and Iceberg table metadata is reachable from both directions. Destructive operations always confirm first, long operations run on cancellable background workers, and one keystroke re-points the whole application at a different AWS profile or S3 endpoint.

Status: v0.9.0 development; no package release published — install from Git until the aws-tui project name is available on PyPI. Glue, Athena, and their integrated Iceberg workflows are Unreleased v0.9.0 feature work. The package metadata remains 0.8.0 until the release-preparation PR bumps it; the current tree must not be tagged as v0.8.0. The per-release history lives in CHANGELOG.md in the repository, which is the one document these surfaces cannot carry: its version headings resolve through /compare/ links into the repository itself.

1. Features

  • Dual-pane S3 ⇄ local file management — copy, delete, and multi-select across an S3 (or S3-compatible) source and your local filesystem.
  • One-key source switching across every configured AWS profile and S3-compatible connection.
  • EMR Serverless console — application picker, job-runs master-detail with state-filter chips, and on-demand log streaming with a grep filter.
  • AWS Glue read-only operations console — Catalog, Jobs, and Crawlers views with an exact-source bordered picker, bordered job/crawler state selectors, and a typed copied-table reference.
  • Amazon Athena read-only query console — Query, History, Results, and Saved views with fail-closed SQL validation, app-owned cancellation, paginated rows, exact-profile customer-S3 result handoff, keyboard-focusable context selectors, and same-source copied-table insertion without execution.
  • Integrated Iceberg operations — bounded metadata views in Glue, generated Glue → Athena table and snapshot queries with explicit execution, Athena → Glue navigation for one unambiguous table, and S3 artifact handoff.
  • Themable, keyboard-driven — built-in themes and fully customizable keybindings; valid overlays apply on the next launch while invalid overlays fall back atomically. The command palette shows service commands only for the active service.

Glue, Athena, and Iceberg integration are Unreleased minor-version feature work targeting v0.9.0. They remain read-only: generated SQL is placed in the Athena editor for review and never executes automatically.

2. Where to start