kiro-cli-auth

Switch between multiple Kiro CLI accounts quickly.

kiro-cli-auth saves each account as a local snapshot, then restores the selected snapshot into Kiro CLI's active data.sqlite3 when you switch.

Install

npm install -g @911218sky/kiro-cli-auth

You can also run it without installing globally:

npx @911218sky/kiro-cli-auth list

Supported npm platforms:

• Linux x64
• Linux arm64
• macOS x64
• macOS arm64
• Windows x64

The npm package is a small launcher. During install it downloads the matching binary from the GitHub Release for that package version.

Quick Start

Add the current Kiro account:

kiro-cli-auth login work

Add another account:

kiro-cli-auth login personal

List accounts:

kiro-cli-auth list

Switch accounts:

kiro-cli-auth switch work

Stop running Kiro CLI sessions, then switch:

kiro-cli-auth switch --stop work

Show the active account:

kiro-cli-auth current

Remove an account:

kiro-cli-auth remove personal

Commands

kiro-cli-auth login [alias]
kiro-cli-auth list
kiro-cli-auth switch [alias] [--stop]
kiro-cli-auth current
kiro-cli-auth remove [alias]
kiro-cli-auth export [alias] -o <dir>
kiro-cli-auth import <dir>
kiro-cli-auth refresh [alias]
kiro-cli-auth refresh --all
kiro-cli-auth clean
kiro-cli-auth logout
kiro-cli-auth stop
kiro-cli-auth stop --force
kiro-cli-auth update

If switch, remove, or export does not receive an alias, it opens an interactive picker.

Update

Update kiro-cli-auth itself:

kiro-cli-auth update

Or update through npm:

npm update -g @911218sky/kiro-cli-auth

Uninstall

npm uninstall -g @911218sky/kiro-cli-auth

Account data is stored locally:

• Linux/macOS: ~/.kiro-cli-auth/
• Windows: %APPDATA%\kiro-cli-auth\

Remove that directory if you want to delete all saved account snapshots.

Notes

• Close running Kiro CLI sessions before switching accounts.
• Use kiro-cli-auth stop to stop running Kiro CLI sessions before switching accounts.
• Use kiro-cli-auth switch --stop to stop Kiro CLI first, then switch.
• Use kiro-cli-auth refresh --all to refresh cached account usage and status.
• On Linux and Windows, machine IDs are kept in the kiro-cli-auth registry only.
• On macOS, the per-account machine ID is also written to ~/Library/Application Support/Kiro/machineid.
• If Kiro CLI stores data.sqlite3 in a non-standard path, set KIRO_CLI_DATA_PATH to that exact file.