CLI Reference / Platform

Platform Commands

Connect your AWS infrastructure to the Wraps Platform for dashboards, templates, and workflows.

wraps platform connect

Link your AWS account to the Wraps Platform. Enables dashboard features including analytics, template management, and automated workflows.

Usage

terminal.sh

npx @wraps.dev/cli platform connect [options]

Options

--token <token>

API token for authentication. If not provided, uses stored credentials or prompts for login.

--json

Output result as JSON for scripting and automation

What It Does

Authenticates with the Wraps Platform (uses stored token or prompts for login)
Creates or updates an IAM role (wraps-platform-role) with a trust policy for the Wraps Platform
Sets up an EventBridge webhook connection for real-time event streaming
Stores the platform connection in your local metadata
Enables dashboard features: analytics, template management, and workflows

Examples

Interactive connect (uses stored auth or prompts login):

terminal.sh

npx @wraps.dev/cli platform connect

Connect with an API token (for CI/CD):

terminal.sh

npx @wraps.dev/cli platform connect --token wraps_sk_...

wraps platform update-role

Update the IAM role that grants the Wraps Platform read access to your AWS account. Run this after upgrading your infrastructure or changing services.

Usage

terminal.sh

npx @wraps.dev/cli platform update-role [options]

Options

--json

Output result as JSON for scripting and automation

What It Does

Reads your current infrastructure metadata
Creates or updates the wraps-platform-role IAM role with minimum required permissions
Adds a trust policy allowing the Wraps Platform AWS account to assume the role
Updates connection metadata with the new role ARN