Skip to content

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

  1. Click + in the toolbar to open the SSO organizations panel
  2. Enter a name, SSO region (e.g. eu-west-1), and start URL (e.g. https://your-org.awsapps.com/start)
  3. 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.