Use multiple accounts simultaneously without switching.

English | Español | العربية | 中文 | Русский | עברית

Contents

Install · Quick start · AI tools · Commands · Isolation · Move sessions · Troubleshooting · Uninstall

Install

Requirements

• macOS or Linux: Bash 3.2 or newer
• Windows: Windows PowerShell 5.1
• jq 1.7.1, installed automatically when missing
• One of the supported AI tools

Install from source

Git is required for this method.

git clone https://github.com/Spielewoy/multi-cli.git
cd multi-cli
./install/install.sh --local

Windows PowerShell:

git clone https://github.com/Spielewoy/multi-cli.git
cd multi-cli
.\install\install.ps1 -Local

Quick start

multi-cli doctor
multi-cli new claude-cli/work
multi-cli claude-cli/work

Supported AI tools

AI tool	ID	Platforms	Account boundary
AGY CLI	agy-cli	Windows	OS user
Antigravity	antigravity	Windows	OS user
Claude Code	claude-cli	Windows, Linux, macOS API keys	File overlay
Codex CLI	codex	Windows, macOS, Linux	File overlay
Codex Desktop	codex-gui	Windows	OS user
Command Code	commandcode	Windows, macOS, Linux	File overlay
GitHub Copilot CLI	copilot-cli	Windows, macOS, Linux	Process secret
GitHub Copilot in VS Code	copilot-vscode	Windows	OS user
Cursor CLI	cursor-cli	Windows, macOS, Linux	Process secret
Cursor Desktop	cursor	Windows, macOS, Linux	Isolated tool home
Gemini CLI	gemini-cli	Windows, macOS, Linux	File overlay
Grok Build CLI	grok-cli	Windows, macOS, Linux	Process secret
Kimi Code CLI	kimi-cli	Windows, macOS, Linux	Process secret
Kiro	kiro	Windows, macOS, Linux	OS user
OpenCode	opencode	Windows, macOS, Linux	Isolated tool home
Windsurf	windsurf	Windows, macOS, Linux	OS user
Zed	zed	Windows	OS user

See platform limits in the support matrix. Run multi-cli tools to check your machine.

Commands

Profiles

Command	Action
multi-cli new <tool>/<name>	Create an account profile (credentials separate; normal state shared)
multi-cli new <tool>/<name> --isolated	Create a whole-root isolated profile when the AI tool supports it; aliases: --isolate, -i
multi-cli new <tool>/<name> --from <template>	Create a schema-v2 profile from a schema-v2 template
multi-cli <tool>/<name>	Launch a profile
multi-cli launch <tool>/<name> [-- args...]	Launch and pass arguments to the tool
multi-cli list [<tool>]	List profiles
multi-cli clone <tool>/<src> <tool>/<dest>	Copy a schema-v2 profile
multi-cli rename <tool>/<old> <tool>/<new>	Rename a profile
multi-cli delete <tool>/<name>	Delete a profile after confirmation

Credentials and portability

Command	Action
multi-cli auth set <tool>/<profile>	Store a process secret in the OS credential store
multi-cli auth status <tool>/<profile>	Check whether that secret exists
multi-cli auth clear <tool>/<profile>	Remove that secret
multi-cli continue <tool> <src> <dest> [--dry-run] [--no-merge]	Copy supported session state, never credentials
multi-cli template save <tool>/<profile> <name>	Save a credential-free schema-v2 template
multi-cli template list | delete <name>	List or delete templates
multi-cli export <tool>/<name> [path]	Export a schema-v2 profile
multi-cli import <archive> <tool>/<name>	Import a schema-v2 archive

Maintenance

Command	Action
multi-cli migrate <tool>/<name> [--dry-run] [--prefer-profile]	Migrate a legacy profile to schema v2
multi-cli status	Show profiles and sizes
multi-cli stats	Show profile storage use
multi-cli doctor [--deep]	Diagnose setup and optionally audit runtimes
multi-cli completion {bash|zsh|powershell}	Print shell completion setup
multi-cli help	Show every command
multi-cli version	Show the installed version

How isolation works

Mode	What stays separate	What stays shared
File overlay	Declared credential files	Native configuration and conversations
Process secret	One credential injected into the child process	The tool's normal state
OS user	The product's fixed OS credential identity	Nothing unless the AI tool allows it
Isolated tool home	The entire tool home	Nothing

Profiles use the narrowest supported boundary. --isolated creates a separate tool home. Fixed OS credentials use a Multi-CLI-owned OS user and require an elevated terminal on Windows.

AI tools using a process secret require one extra step:

multi-cli new cursor-cli/work
multi-cli auth set cursor-cli/work
multi-cli cursor-cli/work

Older profiles keep their original whole-root behavior. Preview migration with:

multi-cli migrate codex/work --dry-run

Only schema-v2 profiles, templates, and archives are portable. Migrate legacy profiles first.

Move sessions between accounts

Copy supported conversation state when one account reaches a limit:

multi-cli continue codex work personal --dry-run
multi-cli continue codex work personal
multi-cli codex/personal
codex resume

base refers to the tool's normal home, so either side can be a profile or the default installation. Credentials are never copied. Session transfer is supported for codex, claude-cli, gemini-cli, and commandcode.

Shell aliases

Each profile gets a shortcut such as claude-cli-work.

Platform	Location
macOS and Linux	~/MultiCliProfiles/bin/
Windows	~/MultiCliProfiles/bin/, plus Start Menu shortcuts for GUI profiles

Configuration

Variable	Default	Purpose
MULTICLI_HOME	~/MultiCliProfiles	Profile storage
MULTICLI_OVERRIDE_BINARY	unset	Override binary discovery for one launch
MULTICLI_REPO	GitHub repository	Override the install source
MULTICLI_INSTALL_DIR	platform default	Override the installation directory

Troubleshooting

multi-cli doctor
multi-cli doctor --deep
multi-cli tools

Restart the terminal if multi-cli or a new profile alias is not found after installation. The support matrix covers product-specific requirements.

Uninstall

macOS and Linux:

curl -fsSL https://raw.githubusercontent.com/Spielewoy/multi-cli/main/install/uninstall.sh | bash

Windows PowerShell:

irm https://raw.githubusercontent.com/Spielewoy/multi-cli/main/install/uninstall.ps1 | iex

Profile data is preserved unless you confirm its removal.

Links

• Support matrix
• Security policy
• Contributing
• Support

License

MIT