Switch Kiro profiles without signing out.
Manage all your Kiro accounts without signing out or swapping ~/.kiro files by hand.
Free to download · macOS 14.0 (Sonoma) or later

Interface
MenuBar + CLI
Real-time kqueue sync
Isolation
Atomic Symlinks
Never overrides $HOME
Native
Pure Swift
Tiny memory footprint
Safety
100% Reversible
One-command keo eject
01 / The Problem It Solves
Stop signing out and moving ~/.kiro files by hand.
By default, kiro-cli maintains a single active session database (data.sqlite3) and a single global configuration folder. Switching between your company’s AWS IAM Identity Center and your personal account shouldn’t break your workflow.
Single global state & constant re-login
- ✕Repeatedly running
kiro-cli logoutand completing browser SSO flows every time you switch contexts. - ✕Enterprise MCP servers (
mcp.json), steering rules, and custom skills leak into personal projects—or get overwritten. - ✕Overriding
HOMEin shell wrappers breaksgit,ssh, andawscredentials. - ✕Manually copying
data.sqlite3while a session is active risks WAL database corruption.
Isolated sandboxes & instant switching
- ✓Authenticate once per profile (
personal,work,builder) and switch in 1 click or viakeo use. - ✓Each profile owns an isolated
~/.keo/<profile>sandbox forsteering,skills,mcp.json, andcloud-cache. - ✓Atomic symlink switching keeps your real
$HOMEuntouched so all developer tools work natively. - ✓Built-in
ProcessGuardand onlinesqlite3_backupguarantee zero database corruption.
02 / Dual Workflow
One core engine. Menu bar & terminal in real-time sync.
Whether you prefer clicking the macOS status bar or staying in your shell, both interfaces share KeoCore and watch ~/.keo/config.json via macOS kqueue events.
Native SwiftUI Status Bar App
Built with native AppKit and SwiftUI. Lives quietly in your macOS menu bar with zero Dock clutter and negligible memory footprint.
Scriptable CLI Companion
Bundled inside Keo.app and symlinked into your PATH without requiring sudo. Switch profiles in terminal and watch the menu bar update immediately.
$ keo list
personal [social]
* work [idc (https://company.awsapps.com/start, us-east-1)]
builder [builder-id]
$ keo use personal
Switched active profile to 'personal'.
# Open a new terminal tab/window for the new session
$ keo current
personal
03 / Engineered for Reliability
Transactional profile switching with zero side effects.
Every profile switch is backed by automatic rollback, online SQLite backups, and strict POSIX permissions—written in pure Swift with zero external dependencies.
Isolated Profile Login
keo create runs kiro-cli login inside a temporary isolated environment without touching your active session. Supports Social, AWS Builder ID, IAM Identity Center, and External IdP.
WAL Corruption Protection
Inspects active kiro-cli processes via lsof and run-receipts before switching. If an interactive session has data.sqlite3 open in WAL mode, Keo safely blocks the switch.
100% Reversible (keo eject)
Adopts your existing ~/.kiro directory into a default profile recorded in adopt-backup.json. Run keo eject anytime to remove symlinks and restore real files in place.
04 / How It Works
Up and running in 30 seconds.
Open Keo.app to use the guided 3-step Onboarding Wizard, or initialize directly from your terminal with keo init.
Verify kiro-cli binary
On first launch, Keo’s Setup Wizard locates your kiro-cli executable and validates its version before making any changes.
Register keo in PATH
Creates a symbolic link pointing inside Keo.app and configures automatically, no administrator password required.
Adopt your default profile
Migrates your current config (steering, skills, mcp.json, cloud-cache) and active session into the initial profile without losing a single file.
Isolated per-profile directory tree
Every profile stores its own configuration files and credential vault inside ~/.keo/<profile>:
~/.keo/
├── config.json # Keo configuration;
├── adopt-backup.json # Manifest for 'keo eject'
└── work/
└── .kiro/
├── steering/ # Profile steering rules
├── skills/ # Profile skills
├── settings/
│ └── mcp.json # Profile MCP servers
└── cloud-cache/ # Resolved account cache
05 / Command-Line Reference
Full lifecycle control from your terminal.
The keo CLI is built with swift-argument-parser and ships inside Keo.app. Everything you need is nine subcommands away.
Adopt your existing ~/.kiro configuration
Import your current active session and global configuration as 'default', then rename it to 'personal'.
keo init
keo rename default personal --forceCreate an AWS IAM Identity Center profile
Authenticate an enterprise account in an isolated sandbox while optionally cloning your current skills and steering.
keo create work \
--from-current \
--license pro \
--identity-provider https://company.awsapps.com/start \
--region us-east-1 \
--use-device-flowAdd an AWS Builder ID or Social profile
Spin up a clean profile for side projects or open-source work without signing out of your company account.
keo create builder \
--license free \
--use-device-flowSwitch profiles, run diagnostics, or eject
Switch active profiles in milliseconds, verify symlink/SQLite health with doctor, or restore real files anytime.
keo use work
keo doctor
keo ejectAll CLI Subcommands (keo --help)
keo initAdopt current ~/.kiro config into 'default'.
keo create <name>Create & authenticate a profile in isolation.
keo use <name>Atomically switch the active profile.
keo listList all profiles and auth provider types.
keo currentPrint the currently active profile name.
keo rename <a> <b>Rename an existing profile sandbox.
keo delete <name>Remove a profile's local sandbox.
keo doctorVerify symlinks, SQLite DBs, and kiro-cli.
keo ejectRevert symlinks and restore ~/.kiro files.