Setup Guide: Kiro IDE + Kiro CLI + WSL + AWS Transform Custom

Install Kiro IDE on Windows

Go to https://kiro.dev/downloads/
Download the Windows installer.
Run the installer and follow the prompts.
Launch Kiro IDE and sign in with AWS IAM Identity Center:

Start URL: https://thaiairways.awsapps.com/start

Region: ap-southeast-1
Complete authentication in the browser and allow access to Kiro when prompted.

Install Kiro CLI on Windows

Open Windows Terminal (PowerShell) and run:
PowerShell
```
irm 'https://cli.kiro.dev/install.ps1' | iex
```
Verify the installation:
PowerShell
```
kiro-cli --version
```
Authenticate. At the command line, enter kiro-cli or kiro-cli login. You will be prompted to press Enter to complete sign-in in your browser.

In your browser, choose your organization:

Start URL: https://thaiairways.awsapps.com/start

Region: ap-southeast-1
After you authenticate, your browser directs you back to your terminal.
When you return to your terminal, run kiro-cli again to access Kiro.

Install WSL with Ubuntu

Required only if you plan to run AWS Transform Custom through WSL (see Part 4, Option B).

Open Windows Terminal (PowerShell) as Administrator and run:
PowerShell (Admin)
```
wsl --install
```
This installs WSL 2 with Ubuntu by default. Restart when prompted.
After restart, Ubuntu launches automatically. Set your username and password.
Update Ubuntu:
Ubuntu (bash)
```
sudo apt update && sudo apt upgrade -y
```

Install AWS Transform Custom (atx)

ⓘ

Choose one path below. Option A (Windows native) is the fastest if you just need the atx CLI. Option B (WSL) is the Linux path and pairs well with the AWS CLI setup in Ubuntu.

Install atx on Windows (PowerShell)

Open Windows Terminal (PowerShell) and run:

PowerShell

irm https://transform-cli.awsstatic.com/install.ps1 | iex

Close and reopen your terminal (or start a new PowerShell session) so the updated PATH is picked up, then verify:

PowerShell

atx --version

⚠

Note: This option runs atx inside WSL (Ubuntu). Complete Part 3 first. If you prefer to stay on Windows, use Option A instead.

4.1 Install prerequisites

Ubuntu (bash)

sudo apt install -y git unzip curl
node --version   # should be 22+

4.2 Install AWS CLI v2 in WSL

Reference: AWS CLI Installation Guide

Ubuntu (bash)

curl -fsSL https://awscli.amazonaws.com/v2/install.sh | bash

4.3 Install AWS Transform Custom CLI (atx)

Reference: AWS Transform Custom Getting Started

Ubuntu (bash)

curl -fsSL https://transform-cli.awsstatic.com/install.sh | bash

Run the source command shown in the installation output above, or restart WSL. Then verify:

Ubuntu (bash)

atx --version

4.4 Configure the AWS Region for atx

⚠

atx runs in different Regions than the Kiro sign-in in Parts 1–2. AWS Transform Custom is not available in ap-southeast-1 (Singapore). Choose one of the supported Regions below. The examples use ap-southeast-2 (Sydney), the closest supported Region to Thailand.

Supported Regions: us-east-1 · eu-central-1 · eu-west-2 · ca-central-1 · ap-northeast-1 · ap-northeast-2 · ap-southeast-2 · ap-south-1

atx uses your standard AWS CLI Region setting. Set it once so it persists across sessions:

PowerShell / bash

aws configure set region ap-southeast-2

Or set it for the current session only (this takes precedence over the config file):

PowerShell

$env:AWS_REGION = "ap-southeast-2"

bash

export AWS_REGION=ap-southeast-2

Verify the Region atx will use:

PowerShell / bash

aws configure get region

ⓘ

If your credentials use a named profile, add --profile your_profile_name to the set command and set AWS_PROFILE. If pointed at an unsupported Region, atx shows a clear error telling you to switch to a supported one.

↓

Supplementary Downloads

Additional material for the workshop. Download and extract as directed by your facilitator.

📦

atx-artifacts.zip

AWS Transform Custom artifacts · ZIP · ~133 KB

Download