Troubleshooting the Category SDK

• alexa-ai-user is the base credential profile (IAM User keys)
• alexa-ai is the role assumption profile (AddOn3PDeveloperToolsRead). If you used different profile names during setup, replace accordingly.

​

alexa-ai new or alexa-ai test Fails with git clone error

​

Symptom

fatal: unable to access 'https://git-codecommit.us-west-2.amazonaws.com/v1/repos/...': The requested URL returned error: 403

1. Verify your IAM user credentials are valid.
    aws sts get-caller-identity --profile alexa-ai-user
   
   If this fails → your Access Key ID or Secret Access Key is invalid or rotated. Generate new keys in your AWS IAM console.
2. Verify role assumption works
    aws sts get-caller-identity --profile alexa-ai
   
   If this fails → check that your IAM user has the sts:AssumeRole policy attached.
3. Clear cached credentials macOS:
    git credential-osxkeychain erase
    host=git-codecommit.us-west-2.amazonaws.com
    protocol=https
   
   Press Enter twice after the protocol line. Ubuntu/Linux (libsecret):
    printf "protocol=https\nhost=git-codecommit.us-west-2.amazonaws.com\n" | git-credential-libsecret erase
   
   Ubuntu/Linux (store — plaintext file):
    sed -i '/git-codecommit.us-west-2.amazonaws.com/d' ~/.git-credentials
   
   Ubuntu/Linux (cache — in-memory):
    git credential-cache exit
   
4. Verify git credential helper is configured.
    git config --global --get "credential.https://git-codecommit.us-west-2.amazonaws.com.helper"
   
   Expected: !aws codecommit credential-helper --profile alexa-ai $@
5. Test git access manually.
    git ls-remote https://git-codecommit.us-west-2.amazonaws.com/v1/repos/category-restaurant-reservation-template-typescript
   

​

npm install fails with 401 Unauthorized

npm error 401 Unauthorized - GET https://alexa-ai-372468808636.d.codeartifact.us-west-2.amazonaws.com/...

1. Re-authenticate (CodeArtifact token expires every 12 hours):
    aws codeartifact login \
      --tool npm \
      --domain alexa-ai \
      --repository npm-packages \
      --domain-owner 372468808636 \
      --region us-west-2 \
      --namespace @alexa-ai \
      --profile alexa-ai
   
2. If the issue persists, delete the @alexa-ai entries from ~/.npmrc: macOS:
    sed -i '' '/@alexa-ai/d' ~/.npmrc
   
   Ubuntu/Linux:
    sed -i '/@alexa-ai/d' ~/.npmrc
   
3. Re-run the login command from step 1 to regenerate fresh entries.
4. Verify the registry is configured correctly:
    npm config get @alexa-ai:registry
   
   Expected: https://alexa-ai-372468808636.d.codeartifact.us-west-2.amazonaws.com/npm/npm-packages/

​

CDK deploy fails with credential errors

Unable to resolve AWS account to use

aws sts get-caller-identity

​

4xx error thrown by API Gateway