First setup
On first launch (when ~/.aws/config has no SSO profiles), Mimic shows a Setup panel at the top of the main window. It checks:
- [x] AWS CLI installed and on PATH
- [x] Profiles available in config
- [x] SSO organizations configured
Step 1: Add your SSO organization
- Click + in the toolbar to open the SSO organizations panel
- Enter a name, SSO region (e.g.
eu-west-1), and start URL (e.g.https://your-org.awsapps.com/start) - Click Sync
Step 2: Sync profiles
Sync contacts AWS Identity Center to discover all accounts and roles you have access to. Generated profiles are written to ~/.aws/config inside # BEGIN/END MIMIC GENERATED SSO PROFILES markers.
Step 3: Log in
Click Login on any profile to authenticate via browser SSO.
Step 4 (optional): Set a default profile
See shell integration to set up automatic AWS_PROFILE in every terminal.