awsui

A powerful, user-friendly terminal interface for AWS Profile and SSO management

Built with Textual for a modern, responsive TUI experience

⚡ Fast 🔐 Secure 🤖 AI-Powered 🌍 Bilingual

Get Started View on GitHub

Why awsui?

⚡

Lightning Fast

Search and switch between dozens of AWS profiles in milliseconds with real-time fuzzy matching

🔐

SSO Made Easy

Automatic re-authentication when credentials expire - no manual login headaches

🤖

AI-Powered Assistant

Integrated Amazon Q Developer CLI for intelligent AWS assistance with streaming responses

🎯

Smart CLI

Command autocomplete with AWS CLI cheatsheet built-in for 15+ services

🌍

Bilingual Support

Full support for English and Traditional Chinese interfaces

📊

Clear Visibility

See profile details, account info, and current identity at a glance

🎨

Modern UX

Beautiful, keyboard-driven interface that respects your terminal theme

🔒

Secure by Design

Uses AWS CLI's credential system - no credential storage or caching

See It in Action

⚡ Fast profile search and switching with real-time filtering

🎯 Smart CLI with command autocomplete and inline execution

🤖 AI-powered Amazon Q Developer integration with streaming responses

📚 Built-in AWS CLI cheatsheet with quick reference for 15+ services

Quick Start

Install with uv (Recommended)

# Install as a tool (isolated environment)
uv tool install --python 3.13 awsui

# Run directly
awsui

Install with pip

# Install from PyPI
pip install awsui

# Run
awsui

Requirements

Python: ≥ 3.13, < 3.14
AWS CLI: v2 (required)
Amazon Q CLI: Optional, for AI assistance
uv: Recommended for dependency management

Key Shortcuts

/ Focus search box

↑ ↓ Navigate profiles

Enter Apply selected profile

c Focus CLI input

a Toggle AI assistant

h Show cheatsheet

l Force SSO login

w Show current identity

q Quit