aisw

Named profile and context manager for Claude Code, Codex CLI, and Gemini CLI. Store per-tool accounts, save mixed-name work modes, and switch between them in one command across all three AI coding agents - on macOS, Linux, and Windows.

If you maintain separate work and personal accounts for Claude Code, Codex, or Gemini - or manage credentials for multiple clients - aisw gives you one command to switch instead of manually editing ~/.claude/.credentials.json, juggling CLAUDE_CONFIG_DIR overrides, or copying auth.json files between directories.

Install

brew tap burakdede/tap && brew install aisw

Other installers:

# Shell installer (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/burakdede/aisw/main/install.sh | sh

# Cargo
cargo install aisw

First run

aisw init

init creates ~/.aisw/, configures the optional shell hook, and offers to import any currently logged-in tool accounts so you start with zero manual re-authentication.

Core workflow

# Store profiles
aisw add claude work --api-key "$ANTHROPIC_API_KEY"
aisw add claude personal              # launches interactive OAuth
aisw add codex work --api-key "$OPENAI_API_KEY"
aisw add gemini work --api-key "$GEMINI_API_KEY"

# Activate a profile
aisw use claude work
aisw use --all --profile personal     # switch all tools at once

# Save and activate a mixed-name context
aisw context create acme --claude acme-claude --codex acme-codex --gemini acme-gemini
aisw context use acme

# Inspect state
aisw status
aisw status --context
aisw list

Start here

1. Quickstart - install, first profile, first switch
2. Commands - complete syntax and flag reference
3. How it works - design decisions, credential storage, platform behavior
4. Security - local-only storage, keyring integration, file permissions
5. Automation and scripting - CI patterns, JSON output, non-interactive mode
6. Troubleshooting - common failures and diagnostics

Additional reference

• Adding profiles
• Shell integration
• Workspace guardrails
• Supported tools
• Configuration
• Changelog