multi-cli
by Spielewoy
Run multiple AI coding accounts at the same time.
214stars
15forks
PowerShell
Added 8/19/2026
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
AI Agentsaccount-isolationaccount-managementai-agentsai-codingai-coding-toolsbashclaude-codeclicodex-clicoding-assistantcommand-line-toolcross-platformcursordeveloper-toolsgemini-cligithub-copilotmulti-accountopencodepowershellwindsurf
Installation
# Add to your Claude Code skills
git clone https://github.com/Spielewoy/multi-cliGetting Started
Guides for using ai agents skills like multi-cli.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportVerified
Last scanned: 8/19/2026
{
"issues": [
{
"file": "README.md",
"line": 52,
"type": "remote-install",
"message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://raw.githubusercontent.com/Spielewoy/multi-cli/main/scripts/in\"",
"severity": "low"
}
],
"status": "PASSED",
"scannedAt": "2026-08-19T04:35:56.651Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}English | Español | العربية | 中文 | Русский | עברית
multi-cli
Run multiple account profiles for AI coding tools simultaneously.
By default, each profile gets separate account credentials while conversations, configuration, agents, skills, and plugins stay shared where the tool allows it. Use --isolated when you want the entire tool home separated. Tools whose login cannot be separated safely use OS-user isolation instead. See the support matrix for per-platform requirements.
Profiles created by older multi-cli versions keep their whole-root behavior until migrated — see Legacy Profiles.
Supported Tools
17 adapters ship in this repository. Status is per operating system and binary: supported means multi-cli provides account isolation on that OS (any mode requirements are noted), and unsupported means no isolation mode works there. The authoritative source is docs/support-matrix.md.
| Tool | Kind | Windows | macOS | Linux |
|---|---|---|---|---|
| Claude Code | CLI | supported (file overlay) | supported for API-key profiles only; subscription OAuth is unsupported | supported (file overlay) |
| OpenAI Codex CLI | CLI | supported (file overlay; file credential store mode) | supported | supported |
| Gemini CLI | CLI | supported (file overlay) | supported | supported |
| OpenCode | CLI | supported (--isolated whole-root) |
supported (--isolated whole-root) |
supported (--isolated whole-root) |
| Command Code | CLI | supported (file overlay; use commandcode, bare cmd collides with cmd.exe) |
supported | supported |
| Cursor Desktop | IDE | supported (--isolated whole-root) |
supported (--isolated whole-root) |
supported (--isolated whole-root) |
| Cursor CLI | CLI | supported (process token via multi-cli auth set) |
supported | supported |
| Antigravity | IDE | supported (OS-user isolation; elevated terminal) | unsupported (owned-user GUI/Keychain session not proven) | unsupported (owned-user GUI/Secret Service session not implemented) |
| AGY CLI | CLI | supported (OS-user isolation; elevated terminal) | unsupported (owned-user Keychain isolation not proven) | unsupported (owned-user Secret Service session not implemented) |
| Kiro | IDE | supported (OS-user isolation) | supported (--isolated whole-root) |
supported (--isolated whole-root) |
| Zed | IDE | supported (OS-user isolation; elevated terminal) | unsupported (owned-user GUI/Keychain session not proven) | unsupported (owned-user GUI/Secret Service session not implemented) |
| Devin Desktop / Windsurf | IDE | supported (OS-user isolation; elevated terminal) | supported (--isolated whole-root) |
supported (--isolated whole-root) |
| GitHub Copilot CLI | CLI | supported (process token via multi-cli auth set) |
supported | supported |
| Copilot in VS Code | IDE | supported (OS-user isolation; elevated terminal) | unsupported (owned-user GUI/Keychain session not proven) | unsupported (owned-user GUI/Secret Service session not implemented) |
| Kimi Code CLI | CLI | supported (process token via multi-cli auth set) |
supported | supported |
| Codex Desktop App | GUI | supported (owned Windows user and Store AppX activation) | unsupported (owned-user GUI/Keychain session not proven) | unsupported (no desktop app) |
| Grok Build CLI | CLI/TUI | supported (process token via multi-cli auth set) |
supported | supported |
Each tool has its own folder at the repo root with an adapter.json describing the account boundary, the shared normal state, and the per-OS support status.
Install
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/Spielewoy/multi-cli/main/scripts/install.sh | bash
Windows — open PowerShell:
irm https://raw.githubusercontent.com/Spielewoy/multi-cli/main/scripts/install.ps1 | iex
After install, restart your terminal for PATH changes to take effect.
From source
git clone https://github.com/Spielewoy/multi-cli.git
cd multi-cli
./scripts/install.sh --local # macOS/Linux
.\scripts\install.ps1 -Local # Windows
After install, restart your terminal for PATH changes to take effect.
jq is installed automatically by the installer on all platforms — no manual setup required.
Quick Start
# Create a profile
multi-cli new claude-cli/work
# Launch it
multi-cli launch claude-cli/work
# Or use the shorthand
multi-cli claude-cli/work
Each profile gets an automatic shell alias:
| Platform | Location |
|---|---|
| macOS / Linux | ~/MultiCliProfiles/bin/ (add to PATH) |
| Windows | CLI aliases in ~/MultiCliProfiles/bin/; Start Menu shortcuts for GUI profiles |
Commands
Profile Management
| Command | Description |
|---|---|
multi-cli new <tool>/<name> |
Create an account profile (credentials separate; normal state shared) |
multi-cli new <tool>/<name> --isolated |
Fully isolated schema-v2 profile — shares nothing (whole tool root inside the profile) |
multi-cli new <tool>/<name> --shared |
Legacy schema-v1 shared profile; schema-v2 profiles already share declared normal state by default |
multi-cli new <tool>/<name> --from <tpl> |
Create from a saved template |
multi-cli <tool>/<name> |
Launch a profile (shorthand) |
multi-cli launch <tool>/<name> |
Launch a profile |
multi-cli list [<tool>] |
List all profiles |
multi-cli status |
List profiles with their type and disk size |
multi-cli clone <tool>/<src> <tool>/<dest> |
Copy an existing profile |
multi-cli rename <tool>/<old> <tool>/<new> |
Rename a profile |
multi-cli delete <tool>/<name> |
Delete a profile and all its data |
Account Authentication & Migration
| Command | Description |
|---|---|
multi-cli auth set <tool>/<profile> |
Store the profile's process-secret credential in the OS credential store (prompts interactively, or reads one line from stdin) |
multi-cli auth status <tool>/<profile> |
Report whether a credential is stored for the profile |
multi-cli auth clear <tool>/<profile> |
Remove the stored credential |
multi-cli migrate <tool>/<name> [--dry-run] [--prefer-profile] |
Migrate a legacy schema-v1 profile to schema-v2 |
auth applies only to adapters that use the processSecret mechanism (cursor-cli, copilot-cli, kimi-cli, grok-cli). Launch stays disabled until a credential is stored. See Legacy Profiles for migrate.
Templates
| Command | Description |
|---|---|
multi-cli template save <tool>/<profile> <name> |
Save a profile as a reusable template |
multi-cli template list |
List saved templates |
multi-cli template delete <name> |
Remove a template |
Backup & Transfer
| Command | Description |
|---|---|
multi-cli export <tool>/<name> [path] |
Archive a profile to .tar.gz (.zip on Windows) |
multi-cli import <archive> <tool>/<name> |
Restore a profile from an archive |
Sessions
| Command | Description |
|---|---|
multi-cli continue <tool> <src> <dest> |
Copy conversation state (sessions/transcripts/history) from one profile to another — never credentials |
multi-cli continue <tool> <src> <dest> --no-merge |
Overwrite destination files instead of keeping newer ones |
multi-cli continue <tool> <src> <dest> --dry-run |
Preview what would be copied, change nothing |
base works as a profile name on either end and means the tool's real home dir (~/.codex, ~/.claude, …). Supported for codex, claude-cli, gemini-cli, and commandcode. See Continue a Chat Across Accounts.
Utilities
| Command | Description |
|---|---|
multi-cli tools |
List all supported tools and their install status |
multi-cli stats |
Show disk usage per profile |
multi-cli doctor |
Diagnose your environment |
multi-cli completion {bash|zsh|powershell} |
Set up shell tab-completion |
multi-cli help |
Show help |
multi-cli version |
Show version |
How Isolation Works
Schema-v2 adapters declare an account mechanism separately from normal state:
| Mechanism | How it works |
|---|---|
fileOverlay |
Credentials stay under the profile; declared normal state links to the native shared tool home. |
processSecret |
A per-profile, highest-precedence credential is injected into only the child process. Launch remains disabled until secure secret storage is configured. |
osUserCredentialStore |
Fixed keychain identities are separated with a multi-cli-owned OS user. Provisioning requires an elevated terminal on Windows. |
inseparable |
The vendor combines auth and normal state; compliant launch fails closed and the limitation is shown. |
Version-1 profiles retain the earlier whole-root env, userDataDir, redirectHome, appdata, and sandboxUser behavior for compatibilit
Frequently Asked Questions
What is multi-cli?
multi-cli is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Spielewoy. Run multiple AI coding accounts at the same time. It has 214 GitHub stars.
Is multi-cli safe to use?
Yes. multi-cli passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
How do I install multi-cli?
Clone the repository with "git clone https://github.com/Spielewoy/multi-cli" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is multi-cli written in?
multi-cli is primarily written in PowerShell. It is open-source under Spielewoy on GitHub, so you can review or fork the full source.
Are there alternatives to multi-cli?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh multi-cli against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
241,003
36,554
JavaScript
AI Agentsai-agentsanthropic
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
201,129
60,215
TypeScript
MCP Serversaiapis
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
185,940
28,768
JavaScript
AI Agentsai-agentsanthropic
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io
128,130
8,769
Rust
AI Agentsai-toolsclaude-code