Skip to main content
The wraps aws commands help you configure AWS credentials locally and diagnose authentication problems before running init or other infrastructure commands.

​
wraps aws setup

Interactive wizard to configure AWS credentials. Guides you through creating or entering an AWS access key, choosing a region, and saving credentials to ~/.aws/credentials. 
wraps aws setup

# Skip confirmation prompts
wraps aws setup --yes
​
-y, --yes
boolean
Skip confirmation prompts during the setup flow.

​
What the wizard does

1

Detect existing credentials

Checks whether credentials are already present in your environment (environment variables, ~/.aws/credentials, or an IAM instance role).
2

Prompt for access key

If no credentials are found, asks for your AWS Access Key ID and Secret Access Key.
3

Select region

Prompts you to choose a default AWS region.
4

Write credentials

Saves the credentials to ~/.aws/credentials and region to ~/.aws/config.
Wraps never stores your AWS credentials. They remain in your local ~/.aws/ directory and are used only to call AWS APIs directly from your machine.

​
wraps aws doctor

Diagnose common AWS configuration problems. Checks credential resolution, assumed role validity, region configuration, and required service access. 
wraps aws doctor
The doctor command reports on:
  • Whether valid credentials are detected and which source they come from (env vars, ~/.aws/credentials, instance role, SSO)
  • The resolved AWS account ID and IAM identity (user or role ARN)
  • Whether the credentials have expired (e.g., SSO session)
  • The configured default region
  • Any obvious permission gaps for Wraps operations
Run wraps aws doctor before opening a support issue — it provides the context needed to diagnose credential and region problems quickly.

Build docs developers (and LLMs) love

Get started for freeTalk to us