switch-profile 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [1.1.0](https://github.com/nicolasdao/switch-profile/compare/v1.0.0...v1.1.0) (2026-03-21)
+
+
+### Features
+
+* add Windows compatibility for profile switching, config parsing, and shell hints ([16ce46b](https://github.com/nicolasdao/switch-profile/commit/16ce46bc5cb1d92fc6d882358eaabc718a157f22))
+
 ## [1.0.0](https://github.com/nicolasdao/switch-profile/compare/v0.2.3...v1.0.0) (2026-03-21)
 
 

package/README.md

@@ -102,7 +102,7 @@ When you select a profile, `switch-profile`:
 
 ### Per-terminal profile isolation
 
-By default, switching profiles updates the global `[default]` section, which affects all terminals. If you need different AWS profiles in different terminals simultaneously, copy and run the `export AWS_PROFILE=<name>` command shown after each switch. This sets an environment variable scoped to that terminal only, so other terminals remain unaffected.
+By default, switching profiles updates the global `[default]` section, which affects all terminals. If you need different AWS profiles in different terminals simultaneously, copy and run the command shown after each switch (`export AWS_PROFILE=<name>` on Linux/macOS, or the PowerShell/CMD equivalent on Windows). This sets an environment variable scoped to that terminal only, so other terminals remain unaffected.
 
 For SSO profiles specifically, it leverages two additional AWS CLI cache directories:
 - `~/.aws/sso/cache/` - SSO session tokens (long-lived, ~24 hours)

package/docs/architecture.md

@@ -38,7 +38,7 @@ The main executable file (with `#!/usr/bin/env node` shebang). Registered as the
 |----------|---------|
 | `switchCmd()` | Main command handler. Checks AWS CLI, shows current profile status, lists profiles, renders the selection menu. |
 | `setProfileToDefault(name, list, msg)` | Gets credentials for a profile, writes them as the `[default]` profile. Shows a clear error if the profile is not found in the list. Displays the `export AWS_PROFILE` hint on success. |
-| `printExportHint(profileName)` | Displays a cyan box with the `export AWS_PROFILE=<name>` command for per-terminal profile isolation. Box width adjusts dynamically to the profile name length. |
+| `printExportHint(profileName)` | Displays a cyan box with the profile isolation command. On Linux/macOS shows `export AWS_PROFILE=<name>`. On Windows shows both PowerShell (`$env:AWS_PROFILE`) and CMD (`set AWS_PROFILE`) variants. Box width adjusts dynamically. |
 | `createNewProfile(profiles, makeItDefault)` | Walks the user through creating a standard or SSO profile. Displays an SSO Setup Guide before SSO creation and checks for errors before reporting success. |
 | `chooseProfileName(denyList)` | Validates profile name input (lowercase alphanumeric, dashes, underscores, min 2 chars, no duplicates). |
 | `chooseRegions()` | Autocomplete region picker from the 24 supported AWS regions. |
@@ -57,6 +57,8 @@ The core module. Handles all interactions with AWS configuration files and the A
 - Creating, deleting, and listing profiles.
 - Refreshing expired SSO sessions (including browser redirect).
 
+**Windows compatibility:** Uses `IS_WINDOWS` (`process.platform === 'win32'`) to select platform-appropriate line separator for parsing (`LINE_SEP`: regex `/\r?\n/` on Windows, `os.EOL` otherwise), newline character for writing (`NL`: `'\n'` on Windows, `os.EOL` otherwise), and `shell: true` for `spawn` on Windows (required because `aws` is a `.cmd` batch file).
+
 See [AWS Profile Management](aws-profile-management.md) for a detailed breakdown of every function.
 
 ### `src/aws/regions.js` - Region Definitions

package/docs/aws-profile-management.md

@@ -202,7 +202,7 @@ If the config or credentials files don't exist, they are created with a default
 
 Creates an SSO profile by spawning the interactive `aws configure sso --profile <name>` command. This hands control to the AWS CLI, which walks the user through the SSO setup (URL, region, account, role).
 
-Uses `spawn` with `stdio: 'inherit'` so the user interacts directly with the AWS CLI process. Checks the exit code of the spawned process and throws an error if it is non-zero, indicating the SSO setup failed.
+Uses `spawn` with `stdio: 'inherit'` so the user interacts directly with the AWS CLI process. On Windows, `shell: true` is also passed because `aws` is typically a `.cmd` batch file that requires shell resolution. Checks the exit code of the spawned process and throws an error if it is non-zero, indicating the SSO setup failed.
 
 #### `deleteProfiles(profiles)`
 

package/docs/cli-interface.md

@@ -21,7 +21,7 @@ Before anything else, the tool verifies AWS CLI v2+ is installed. If not found,
 
 - **macOS:** `brew install awscli && brew link --overwrite awscli`
 - **Linux:** curl + unzip instructions for the AWS CLI v2 installer
-- **Windows:** Generic "not installed" message
+- **Windows:** "Not installed" message with a link to the AWS CLI MSI installer download page
 
 ### Step 2: Default Profile Status
 
@@ -82,6 +82,7 @@ Selecting a profile from the list sets it as the `default`. For SSO profiles, th
 
 On success:
 
+**Linux / macOS:**
 ```
 AWS profile sso-dev successfully set up as default.   # Green
 
@@ -94,7 +95,21 @@ AWS profile sso-dev successfully set up as default.   # Green
 └─────────────────────────────────────────────────────────┘
 ```
 
-This hint appears after every successful profile switch, refresh, or new profile set as default. Running the displayed `export` command sets the `AWS_PROFILE` environment variable in the current terminal only, enabling per-terminal profile isolation.
+**Windows:**
+```
+AWS profile sso-dev successfully set up as default.   # Green
+
+┌──────────────────────────────────────────────────────────────┐
+│  To lock this profile to this terminal session, run:         │  # Cyan
+│                                                              │
+│    PowerShell:  $env:AWS_PROFILE = "sso-dev"                 │  # Cyan + Bold
+│    CMD:         set AWS_PROFILE=sso-dev                      │  # Cyan + Bold
+│                                                              │
+│  This prevents other terminals from affecting this one.      │
+└──────────────────────────────────────────────────────────────┘
+```
+
+This hint appears after every successful profile switch, refresh, or new profile set as default. Running the displayed command sets the `AWS_PROFILE` environment variable in the current terminal only, enabling per-terminal profile isolation.
 
 ### Step 4b: More Options
 
@@ -244,6 +259,7 @@ Selecting it:
 2. Retrieves fresh credentials (SSO login if needed).
 3. Updates the `[default]` section.
 
+**Linux / macOS:**
 ```
 AWS profile sso-dev successfully refreshed.    # Green
 
@@ -256,6 +272,8 @@ AWS profile sso-dev successfully refreshed.    # Green
 └─────────────────────────────────────────────────────────┘
 ```
 
+On Windows, the hint shows PowerShell and CMD equivalents instead (see [Step 4a](#step-4a-select-a-profile)).
+
 ## Visual Indicators
 
 | Color | Meaning |
@@ -265,7 +283,7 @@ AWS profile sso-dev successfully refreshed.    # Green
 | **Cyan** | Informational (current profile, time remaining) |
 | **Yellow** | Warnings (expired, expiring soon) |
 | **Bold** | Profile names in messages |
-| **Cyan + Bold** | Export command hint (the `export AWS_PROFILE=...` line) |
+| **Cyan + Bold** | Profile isolation command hint (`export AWS_PROFILE=...` on Unix, PowerShell/CMD equivalents on Windows) |
 
 ## Error Display
 

package/docs/gotchas.md

@@ -35,11 +35,15 @@ After every successful switch, `switch-profile` displays a box like:
 └─────────────────────────────────────────────────────────┘
 ```
 
-Running `export AWS_PROFILE=dev` sets an environment variable **scoped to that terminal session only**. The AWS CLI and all AWS SDKs honor `AWS_PROFILE` and will use the named profile directly — bypassing `[default]` entirely. Other terminals remain unaffected.
+Running the displayed command sets an environment variable **scoped to that terminal session only**. The AWS CLI and all AWS SDKs honor `AWS_PROFILE` and will use the named profile directly — bypassing `[default]` entirely. Other terminals remain unaffected.
+
+On **Linux / macOS**: `export AWS_PROFILE=dev`
+On **Windows (PowerShell)**: `$env:AWS_PROFILE = "dev"`
+On **Windows (CMD)**: `set AWS_PROFILE=dev`
 
 ### The limitation: you must copy-paste it yourself
 
-`switch-profile` **cannot** set the environment variable for you. This is a fundamental operating system constraint: a child process (the `npx` command) cannot modify the environment of its parent process (your terminal shell). The `export` command must be run directly in the terminal by the user.
+`switch-profile` **cannot** set the environment variable for you. This is a fundamental operating system constraint: a child process (the `npx` command) cannot modify the environment of its parent process (your terminal shell). The displayed command (`export` on Unix, `$env:` on PowerShell, `set` on CMD) must be run directly in the terminal by the user.
 
 There is no workaround for this within the tool itself. The user must manually copy-paste and run the `export AWS_PROFILE=<name>` command shown after each switch.
 

package/index.js

@@ -6,6 +6,7 @@
 const program = require('commander')
 const inquirer = require('inquirer')
 const { EOL } = require('os')
+const IS_WINDOWS = process.platform === 'win32'
 const { listProfiles, getCredentials, getDefaultProfile, updateDefaultProfile, deleteProfiles, createProfile, regions, createSsoProfile, awsCliV2Exists } = require('./src/aws')
 const { printAWSerrors } = require('./src/core')
 require('colors')
@@ -179,7 +180,8 @@ const switchCmd = async () => {
 			console.log('brew link --overwrite awscli')
 			return 
 		} else if (process.platform == 'win32') {
-			console.log('AWS CLI seems to not be installed.'.red)
+			console.log('AWS CLI seems to not be installed. Download the installer from:\n'.red)
+			console.log('https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html')
 			return
 		} else {
 			console.log('AWS CLI seems to not be installed. Try installing it as follow\n'.red)
@@ -331,7 +333,14 @@ const switchCmd = async () => {
 }
 
 const printExportHint = (profileName) => {
-	const lines = [
+	const lines = IS_WINDOWS ? [
+		'  To lock this profile to this terminal session, run:  ',
+		'',
+		`    PowerShell:  $env:AWS_PROFILE = "${profileName}"`,
+		`    CMD:         set AWS_PROFILE=${profileName}`,
+		'',
+		'  This prevents other terminals from affecting this one.  '
+	] : [
 		'  To lock this profile to this terminal session, run:  ',
 		'',
 		`    export AWS_PROFILE=${profileName}`,
@@ -342,9 +351,11 @@ const printExportHint = (profileName) => {
 	const pad = s => s + ' '.repeat(width - s.length)
 	console.log('')
 	console.log(('┌' + '─'.repeat(width) + '┐').cyan)
+	const boldStart = IS_WINDOWS ? 2 : 2
+	const boldEnd = IS_WINDOWS ? 3 : 2
 	for (let i = 0; i < lines.length; i++) {
 		const content = '│' + pad(lines[i]) + '│'
-		console.log(i === 2 ? content.cyan.bold : content.cyan)
+		console.log(i >= boldStart && i <= boldEnd ? content.cyan.bold : content.cyan)
 	}
 	console.log(('└' + '─'.repeat(width) + '┘').cyan)
 	console.log('')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "switch-profile",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "main": "index.js",
   "bin": "index.js",
   "description": "NPX script that exposes terminal shortcut to easily switch between cloud configuration (aws, gcp).",

package/src/aws/index.js

@@ -6,6 +6,9 @@ const { spawn } = require('child_process')
 const fileHelper = require('../fileHelper')
 const regions = require('./regions')
 
+const IS_WINDOWS = process.platform === 'win32'
+const LINE_SEP = IS_WINDOWS ? /\r?\n/ : EOL
+const NL = IS_WINDOWS ? '\n' : EOL
 const SSO_GET_CREDS_TIMEOUT = 5*60*1000 // 5 minutes to complete the SSO login
 const AWS_CONFIG_FILE = join(homedir(), '.aws', 'config')
 const AWS_CREDS_FILE = join(homedir(), '.aws', 'credentials')
@@ -100,7 +103,7 @@ const listProfiles = () => catchErrors((async () => {
 	return profiles.map(profile => {
 		const [,rest=''] = configStr.split(profile)
 		const [config=''] = rest.split('[')
-		const params = config.split(EOL)
+		const params = config.split(LINE_SEP)
 		const p = {
 			name: profile.replace(/(^\[profile\s+|\[|\])/g, ''),
 			sso_start_url: getParam(params, 'sso_start_url'),
@@ -118,7 +121,7 @@ const listProfiles = () => catchErrors((async () => {
 			const ssoSessionMatch = configStr.split(ssoSessionSection)
 			if (ssoSessionMatch.length > 1) {
 				const [ssoSessionRest=''] = ssoSessionMatch[1].split('[')
-				const ssoSessionParams = ssoSessionRest.split(EOL)
+				const ssoSessionParams = ssoSessionRest.split(LINE_SEP)
 				p.sso_start_url = getParam(ssoSessionParams, 'sso_start_url')
 				// If sso_region is not in profile, check the session section
 				if (!p.sso_region) {
@@ -384,7 +387,7 @@ const getCredentials = (profile, ssoUrl) => catchErrors((async () => {
 			throw new Error(`Profile ${profile} not found in ${AWS_CREDS_FILE}. Standard profiles must have credentials defined in this file.`)
 
 		const [config=''] = rest.split('[')
-		const params = config.split(EOL)
+		const params = config.split(LINE_SEP)
 		const creds = {
 			aws_access_key_id: getParam(params, 'aws_access_key_id'),
 			aws_secret_access_key: getParam(params, 'aws_secret_access_key'),
@@ -404,16 +407,16 @@ const updateDefaultProfile = ({ profile, region, expiry_date, aws_access_key_id,
 	if (credsStrErrors||configStrErrors)
 		throw wrapErrors(errMsg, credsStrErrors||configStrErrors)
 
-	const newDefaultCreds = '[default]'+EOL+
-		`aws_access_key_id = ${aws_access_key_id}`+EOL+
-		`aws_secret_access_key = ${aws_secret_access_key}`+EOL+
-		(aws_session_token ? `aws_session_token = ${aws_session_token}`+EOL : '') +
-		(expiry_date ? `expiry_date = ${expiry_date.toISOString()}`+EOL : '') +
-		`profile = ${profile}`+EOL+EOL
+	const newDefaultCreds = '[default]'+NL+
+		`aws_access_key_id = ${aws_access_key_id}`+NL+
+		`aws_secret_access_key = ${aws_secret_access_key}`+NL+
+		(aws_session_token ? `aws_session_token = ${aws_session_token}`+NL : '') +
+		(expiry_date ? `expiry_date = ${expiry_date.toISOString()}`+NL : '') +
+		`profile = ${profile}`+NL+NL
 
-	const newDefaultConfig = '[default]'+EOL+
-		`region = ${region}`+EOL+
-		'output = json'+EOL+EOL
+	const newDefaultConfig = '[default]'+NL+
+		`region = ${region}`+NL+
+		'output = json'+NL+NL
 
 	const defaultCredsSection = (credsStr.match(/\[default\]((.|\n|\r)*?)(\[|$)/)||[])[0]
 	const defaultConfigSection = (configStr.match(/\[default\]((.|\n|\r)*?)(\[|$)/)||[])[0]
@@ -442,7 +445,7 @@ const getDefaultProfile = () => catchErrors((async () => {
 	if (errors)
 		throw wrapErrors(errMsg, errors)
 
-	const params = ((credsStr.match(/\[default\]((.|\n|\r)*?)(\[|$)/)||[])[0]||'').split(EOL)
+	const params = ((credsStr.match(/\[default\]((.|\n|\r)*?)(\[|$)/)||[])[0]||'').split(LINE_SEP)
 	const creds = {
 		aws_access_key_id: getParam(params, 'aws_access_key_id'),
 		aws_secret_access_key: getParam(params, 'aws_secret_access_key'),
@@ -526,14 +529,14 @@ const createProfile = ({ name, aws_access_key_id, aws_secret_access_key, region
 	if (configStrErrors||credsStrErrors)
 		throw wrapErrors(errMsg, configStrErrors||credsStrErrors)
 
-	const configProfiles = [`[profile ${name}]`+EOL]
-	const credsProfiles = [`[${name}]`+EOL]
+	const configProfiles = [`[profile ${name}]`+NL]
+	const credsProfiles = [`[${name}]`+NL]
 
-	credsProfiles.push(`aws_access_key_id = ${aws_access_key_id}`+EOL)
-	credsProfiles.push(`aws_secret_access_key = ${aws_secret_access_key}`+EOL+EOL)
+	credsProfiles.push(`aws_access_key_id = ${aws_access_key_id}`+NL)
+	credsProfiles.push(`aws_secret_access_key = ${aws_secret_access_key}`+NL+NL)
 
-	configProfiles.push(`region = ${region}`+EOL)
-	configProfiles.push('output = json'+EOL+EOL)
+	configProfiles.push(`region = ${region}`+NL)
+	configProfiles.push('output = json'+NL+NL)
 
 	const newCreds = credsProfiles.join('')
 	const newConfig = configProfiles.join('')
@@ -543,14 +546,14 @@ const createProfile = ({ name, aws_access_key_id, aws_secret_access_key, region
 	if (!credsStr)
 		credsStr = DEFAULT_CREDS
 
-	await fileHelper.write(AWS_CONFIG_FILE, configStr+EOL+newConfig)
-	await fileHelper.write(AWS_CREDS_FILE, credsStr+EOL+newCreds)
+	await fileHelper.write(AWS_CONFIG_FILE, configStr+NL+newConfig)
+	await fileHelper.write(AWS_CREDS_FILE, credsStr+NL+newCreds)
 })())
 
 const createSsoProfile = name => catchErrors((async () => {
 	await awsCliV2Exists()
 	const exitCode = await new Promise(next => {
-		const child = spawn('aws', ['configure', 'sso', '--profile', name],{ stdio: 'inherit' })
+		const child = spawn('aws', ['configure', 'sso', '--profile', name], { stdio: 'inherit', ...(IS_WINDOWS ? { shell: true } : {}) })
 		child.on('exit', code => next(code))
 	})
 	if (exitCode !== 0)