Mimic docs

Appearance

Common issues ​

macOS Gatekeeper ​

Problem: "Mimic is damaged and can't be opened" on first launch.

Fix: Releases are not codesigned. Run once:

bash
xattr -cr /Applications/Mimic.app

AWS CLI not found ​

Problem: Setup panel shows "Install AWS CLI v2" even though it's installed.

Fix: Ensure aws is on PATH. Mimic detects the CLI by running aws --version. If installed via pip or a non-standard path, add it to your shell config:

bash
export PATH="/path/to/aws:$PATH"

Sync fails ​

Problem: SSO sync fails with "Unable to get identity provider information".

Possible causes:

  • Start URL is incorrect or missing trailing slash
  • Region is incorrect
  • AWS CLI v2 is not installed or outdated
  • Network connectivity to Identity Center endpoint
  • Insufficient permissions in Identity Center

Fix: Verify org settings, check AWS CLI version (aws --version), ensure network access.

Profiles show as misconfigured ​

Problem: Profile has a "misconfigured" badge.

Cause: The profile has sso_session set but the matching [sso-session <name>] block is missing from ~/.aws/config. Run Sync for the organization to regenerate the block, or add it manually.

Token expires immediately ​

Problem: SSO token shows "Expired" right after login.

Fix: The CLI session duration in IAM Identity Center may be set very short. Increase it in IAM Identity Center → Settings → Authentication → Session duration (up to 12h).

Silent refresh not working ​

Problem: Expired sessions don't auto-refresh even though aws sso login --no-browser should work.

Cause: The portal session (browser cookie) has expired. Silent refresh requires a valid browser session with the IdP. Run a full login to re-establish it.