# AWS CLI Commands

Source: https://wraps.dev/docs/cli-reference/aws

CLI Reference / AWS

# AWS Commands

Set up and diagnose your AWS credentials and permissions for Wraps.

## wraps aws setup

Interactive wizard that detects and configures your AWS credentials. Guides you through setting up IAM users or SSO profiles for use with Wraps.

Usage

terminal.sh

```
npx @wraps.dev/cli aws setup
```

What It Does

-   Detects existing AWS configuration (environment variables, `~/.aws/credentials`, SSO profiles)
-   If SSO profiles are found, offers to use an existing profile
-   If no credentials are detected, guides you through IAM user creation or SSO setup
-   Validates credentials by calling STS `GetCallerIdentity`
-   Tests SES permissions to ensure your account can send email
-   Displays your AWS account ID and configured region

Examples

Interactive setup (recommended for first time):

terminal.sh

```
npx @wraps.dev/cli aws setup
```

## wraps aws doctor

Diagnostic tool that checks your AWS configuration and permissions. Run this when you encounter credential or permission errors.

Usage

terminal.sh

```
npx @wraps.dev/cli aws doctor [options]
```

Options

`-r, --region <region>`

AWS region to diagnose. The SES sending-status check is per-region, so this decides which region the report is about.

`--json`

Output diagnostic results as JSON for scripting and automation

What It Checks

-   AWS credential chain (environment variables, profile, SSO, instance role)
-   STS identity validation (`GetCallerIdentity`)
-   SES permissions (`SendEmail`, `GetAccount`)
-   Region configuration and availability
-   Reports any issues with specific fix suggestions

Example Output

output.txt

```
AWS Credential Check  ✓ Credentials found via SSO profile "wraps-dev"  ✓ STS identity validated (Account: 123456789012)  ✓ Region: us-east-1SES Permission Check  ✓ ses:SendEmail — allowed  ✓ ses:GetAccount — allowed  ✓ ses:GetSendQuota — allowedAll checks passed. Your AWS configuration is ready for Wraps.
```

## Next Steps

[

AWS Setup Guide

Detailed walkthrough for configuring your AWS account, credentials, and permissions for Wraps.

Learn more

](https://wraps.dev/docs/guides/aws-setup)

[

Email Commands

Deploy and manage AWS SES email infrastructure with event tracking, analytics, and domain management.

Learn more

](https://wraps.dev/docs/cli-reference/email)

[Back to CLI Reference](https://wraps.dev/docs/cli-reference)[Email Commands](https://wraps.dev/docs/cli-reference/email)