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

100
Your profiles

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.

WITHOUT KEO

Single global state & constant re-login

  • ✕Repeatedly running kiro-cli logout and 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 HOME in shell wrappers breaks git, ssh, and aws credentials.
  • ✕Manually copying data.sqlite3 while a session is active risks WAL database corruption.
WITH KEO

Isolated sandboxes & instant switching

  • ✓Authenticate once per profile (personal, work, builder) and switch in 1 click or via keo use.
  • ✓Each profile owns an isolated ~/.keo/<profile> sandbox for steering, skills, mcp.json, and cloud-cache.
  • ✓Atomic symlink switching keeps your real $HOME untouched so all developer tools work natively.
  • ✓Built-in ProcessGuard and online sqlite3_backup guarantee 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.

macOS MenuBarExtraLSUIElement · No Dock Icon

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.

Terminal Binary~/.local/bin/keo

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.

zsh — keo

$ 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.

MULTI-PROVIDER01

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.

PROCESS GUARD02

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.

SAFE ADOPTION03

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.

STEP 01

Verify kiro-cli binary

On first launch, Keo’s Setup Wizard locates your kiro-cli executable and validates its version before making any changes.

STEP 02

Register keo in PATH

Creates a symbolic link pointing inside Keo.app and configures automatically, no administrator password required.

STEP 03

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.

Sandbox Layout~/.keo/

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.

01 · INITIALIZE

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 --force
02 · ENTERPRISE SSO

Create 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-flow
03 · BUILDER ID / SOCIAL

Add 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-flow
04 · SWITCH & HEALTH

Switch 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 eject

All CLI Subcommands (keo --help)

keo init

Adopt current ~/.kiro config into 'default'.

keo create <name>

Create & authenticate a profile in isolation.

keo use <name>

Atomically switch the active profile.

keo list

List all profiles and auth provider types.

keo current

Print the currently active profile name.

keo rename <a> <b>

Rename an existing profile sandbox.

keo delete <name>

Remove a profile's local sandbox.

keo doctor

Verify symlinks, SQLite DBs, and kiro-cli.

keo eject

Revert symlinks and restore ~/.kiro files.

Keo

Switch contexts as fast as you switch terminals

Requires macOS 14.0 (Sonoma) or later