Config file

Mimic stores its own configuration at ~/.config/mimic/config.json. Override with the MIMIC_CONFIG_DIR environment variable.

Structure

{
  "version": 1,
  "profiles": {
    "profile-name": {
      "label": "My Dev Profile",
      "tags": ["dev", "frontend"],
      "notes": "Used for frontend development",
      "starred": true,
      "hidden": false,
      "order": 0,
      "color": "#ff6b4a"
    }
  },
  "preferences": {
    "theme": "dark",
    "fontSize": "small",
    "defaultView": "compact",
    "identityProviders": [
      {
        "id": "default",
        "name": "My Org",
        "region": "eu-west-1",
        "startUrl": "https://my-org.awsapps.com/start"
      }
    ]
  },
  "activeProfiles": {
    "mimic-my-org": "dev-profile"
  },
  "defaultProfile": "dev-profile"
}

Fields

Field	Description
version	Schema version for migration
profiles	Per-profile metadata keyed by AWS profile name
preferences	App-wide settings
activeProfiles	Maps sso_session → active profile name
defaultProfile	Profile name for shell integration

Legacy migration

version enables schema migrations. Existing configs with ssoDiscoveryRegion / ssoDiscoveryStartUrl are automatically migrated to the identityProviders array on load.