Welcome to the awsui project! This application provides a modern, user-friendly interface for managing your AWS profiles. Enjoy quick profile switching, easy SSO re-authentication, and more, all from your terminal.
To get started, visit the Releases page to download the latest version of awsui. Here's how:
- Click on the link above to open the Releases page.
- Look for the version you want to download.
- Click on the file that matches your operating system. You will find options for Windows, macOS, and Linux.
- Once the download is complete, locate the downloaded file on your computer.
- After downloading, double-click the
.exefile. - If prompted by your system, confirm any security warnings to proceed with the installation.
- Open the downloaded
.dmgfile. - Drag the awsui application to the Applications folder.
- Open your terminal.
- Navigate to the directory where you downloaded the file.
- Run the following command:
chmod +x awsui-linux && ./awsui-linux.
To use awsui, ensure your system meets the following requirements:
-
Operating System:
- Windows 10 or later
- macOS Mojave (10.14) or later
- A modern Linux distribution
-
Dependencies:
- Python 3.8 or higher (if not included in the package)
awsui offers a range of features to improve your AWS experience:
- Lightning-Fast Profile Switching: Quickly switch between your AWS profiles without hassle.
- Seamless SSO Re-authentication: Automatically handle your Single Sign-On sessions to save time.
- Amazon Q Integration: Access Amazon Q features directly from the application.
- Smart CLI Autocomplete: Get suggestions as you type in your terminal, making commands easier.
- Bilingual UI: Choose between multiple languages for a more comfortable experience.
Before you can use awsui, you need to set up your AWS profiles:
- Open the application.
- Go to "Settings" and then "Profiles."
- Add your AWS profiles by entering the necessary credentials, such as your Access Key and Secret Key.
- You can create multiple profiles for different AWS accounts.
Once your profiles are set up, switching is simple:
- Launch the awsui application.
- Use the dropdown menu to select the profile you want to use.
- Click "Switch" to activate the selected profile.
If you need to re-authenticate using SSO:
- Click the "SSO" button in the main interface.
- Follow the on-screen prompts to complete the login process.
If you encounter issues while using awsui, consider the following solutions:
- Application Not Launching: Ensure your operating system meets the requirements. Check if you have the necessary permissions.
- Profile Not Switching: Double-check your AWS credentials for each profile. Make sure there are no typos.
- SSO Issues: Ensure your SSO provider is correctly set up. Check your internet connection.
For additional help, please visit the Issues section of our GitHub repository. Community members and maintainers are available to assist you.
Explore these relevant topics to enhance your understanding and use of awsui:
- amazon-q
- autocomplete
- aws
- aws-iam-identity-center
- cli
- developer-tools
- profile-switcher
- sso
- sts
- terminal
- textual
- tui
By following these steps, you can easily download and run awsui. Enjoy managing your AWS profiles with simplicity and speed!