@ghackk/multi-claude 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gyane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,313 @@
+<div align="center">
+
+<h1>claude-multi-account</h1>
+
+<p><strong>Run multiple Claude CLI accounts with shared settings, plugins, marketplace sync, and backup/restore.</strong></p>
+
+<p>
+  <a href="https://www.npmjs.com/package/multi-claude"><img src="https://img.shields.io/npm/v/multi-claude?color=cb3837&label=npm" alt="npm"></a>
+  <a href="https://pypi.org/project/multi-claude/"><img src="https://img.shields.io/pypi/v/multi-claude?color=3776ab&label=pip" alt="PyPI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+  <img src="https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey" alt="Platform">
+  <a href="https://github.com/ghackk/claude-multi-account/stargazers"><img src="https://img.shields.io/github/stars/ghackk/claude-multi-account?style=social" alt="GitHub Stars"></a>
+</p>
+
+</div>
+
+---
+
+## Why?
+
+Claude CLI stores all config in a single `~/.claude/` directory — so you're locked to **one account at a time**. Switching means logging out, logging in, and losing your settings.
+
+**claude-multi-account** fixes this:
+
+- **Isolated profiles** — each account gets its own config directory, no conflicts
+- **Shared settings** — define MCP servers, env vars, plugins, and CLAUDE.md once — auto-applied everywhere
+- **Plugin & marketplace management** — enable plugins globally or per-account, browse marketplace indexes
+- **One command** — launch any account instantly from an interactive menu
+
+---
+
+## Features
+
+<table>
+<tr>
+<td width="50%">
+
+**Multi-Account Management**<br>
+Create, launch, rename, and delete independent Claude CLI profiles
+
+</td>
+<td width="50%">
+
+**Shared MCP & Settings**<br>
+Define MCP servers, env vars, and preferences once — sync to all accounts
+
+</td>
+</tr>
+<tr>
+<td>
+
+**Plugins & Marketplace**<br>
+Enable/disable plugins globally or per-account, browse and manage marketplace indexes
+
+</td>
+<td>
+
+**Global CLAUDE.md**<br>
+Write instructions and skills that apply across every account
+
+</td>
+</tr>
+<tr>
+<td>
+
+**Backup & Restore**<br>
+Timestamped archives of all accounts and configs with one click
+
+</td>
+<td>
+
+**Export / Import Profiles**<br>
+Copy a profile between machines as a single base64 token — credentials, settings, and launcher included
+
+</td>
+</tr>
+<tr>
+<td>
+
+**Zero Dependencies**<br>
+Just your shell and Claude CLI — nothing else to install
+
+</td>
+<td>
+
+**Run from Repo**<br>
+Add the repo to your PATH — `git pull` instantly updates the menu, no manual copying
+
+</td>
+</tr>
+</table>
+
+---
+
+## Install
+
+Pick any method — they all give you the `claude-menu` (or `multi-claude`) command.
+
+### One-liner (recommended)
+
+```bash
+# Linux / macOS
+curl -fsSL https://raw.githubusercontent.com/ghackk/claude-multi-account/master/install.sh | bash
+```
+
+```powershell
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/ghackk/claude-multi-account/master/install.ps1 | iex
+```
+
+### npm
+
+```bash
+npm install -g multi-claude
+```
+
+### pip
+
+```bash
+pip install multi-claude
+```
+
+### Homebrew (macOS / Linux)
+
+```bash
+brew install ghackk/tap/multi-claude
+```
+
+### Scoop (Windows)
+
+```powershell
+scoop bucket add multi-claude https://github.com/ghackk/scoop-multi-claude
+scoop install multi-claude
+```
+
+### AUR (Arch Linux)
+
+```bash
+yay -S multi-claude
+```
+
+### Manual (git clone)
+
+```bash
+# Linux / macOS
+git clone https://github.com/ghackk/claude-multi-account.git ~/claude-multi-account
+echo 'alias claude-menu="~/claude-multi-account/unix/claude-menu.sh"' >> ~/.bashrc
+```
+
+```powershell
+# Windows
+git clone https://github.com/ghackk/claude-multi-account.git $HOME\claude-multi-account
+[Environment]::SetEnvironmentVariable("PATH", "$HOME\claude-multi-account;" + [Environment]::GetEnvironmentVariable("PATH", "User"), "User")
+```
+
+Then open a new terminal and run `claude-menu`.
+
+---
+
+## Menu Overview
+
+### Main Menu
+
+```
+======================================
+       Claude Account Manager
+======================================
+  Current Accounts:
+
+  1. claude-work     [logged in]   (last used: 02 Mar 2026 10:30 AM)
+  2. claude-personal [logged in]   (last used: 01 Mar 2026 08:15 PM)
+
+======================================
+  1. List Accounts
+  2. Create New Account
+  3. Launch Account
+  4. Rename Account
+  5. Delete Account
+  6. Backup Sessions
+  7. Restore Sessions
+  8. Shared Settings (MCP/Skills)
+  9. Plugins & Marketplace
+  E. Export Profile (Token)
+  I. Import Profile (Token)
+  0. Exit
+======================================
+```
+
+### Shared Settings (Option 8)
+
+Manage universal settings applied to all accounts on launch:
+
+| Option | Action |
+|--------|--------|
+| 1 | Edit MCP + Settings (opens in editor) |
+| 2 | Edit Skills/Instructions (CLAUDE.md) |
+| 3 | View current shared settings |
+| 4 | Sync shared settings to ALL accounts |
+| 5 | Show MCP server list |
+| 6 | Reset shared settings |
+
+### Plugins & Marketplace (Option 9)
+
+Browse marketplace indexes and manage plugins across accounts:
+
+| Option | Action |
+|--------|--------|
+| 1 | Enable plugin for ALL accounts |
+| 2 | Enable plugin for one account |
+| 3 | Disable plugin (shared) |
+| 4 | Disable plugin (one account) |
+| 5 | Browse marketplace plugins |
+| 6 | Marketplace Management (add/remove/sync) |
+
+### Export / Import Profile (Options E & I)
+
+Transfer a profile between machines using a copy-pasteable base64 token:
+
+| Option | Action |
+|--------|--------|
+| E | Export a profile — generates a compact token (~5 KB) containing credentials, settings, and launcher |
+| I | Import a profile — paste the token to restore the account on any machine |
+
+The token bundles only essentials (credentials, settings, CLAUDE.md, launcher) — not cache or conversation history.
+
+---
+
+## How It Works
+
+```
+┌─────────────┐      ┌──────────────────┐      ┌─────────────────┐
+│  You pick    │ ───> │  Shared settings │ ───> │  Claude CLI     │
+│  an account  │      │  + plugins are   │      │  launches with  │
+│  from menu   │      │  merged in       │      │  isolated config│
+└─────────────┘      └──────────────────┘      └─────────────────┘
+```
+
+Each account gets its own config directory (`~/.claude-<name>`). On every launch, shared settings from `~/claude-shared/` are deep-merged into the account — MCP servers, env vars, preferences, plugins, marketplace indexes, and CLAUDE.md instructions all stay in sync.
+
+### Merge Strategy
+
+Settings are **deep-merged** with shared settings winning on conflict:
+
+| Scenario | Result |
+|----------|--------|
+| Key exists only in account | Kept |
+| Key exists only in shared | Added |
+| Key exists in both (simple value) | Shared wins |
+| Key exists in both (nested object) | Recursively merged |
+
+For `CLAUDE.md`, shared content is inserted between auto-managed markers at the top. Account-specific instructions below the markers are preserved.
+
+---
+
+## Folder Structure
+
+```
+~/
+├── claude-multi-account/      # Git repo (can be added to PATH directly)
+│   ├── claude-menu.ps1        # Windows menu script
+│   ├── claude-menu.bat        # Windows launcher
+│   ├── windows/               # Windows-specific scripts
+│   └── unix/                  # Linux/macOS scripts
+│
+├── claude-accounts/           # Account launchers (auto-created)
+│   ├── claude-work.bat/.sh    # Account launcher
+│   └── claude-personal.bat/.sh
+│
+├── claude-shared/             # Shared config (applied to all accounts)
+│   ├── settings.json          # MCP servers, env vars, preferences, enabledPlugins, extraKnownMarketplaces
+│   ├── CLAUDE.md              # Global instructions & skills
+│   └── plugins/               # Shared plugin & marketplace data
+│       └── marketplaces/      # Cached marketplace indexes
+│
+├── claude-backups/            # Timestamped backup archives
+│
+├── .claude-work/              # Account: work (auto-created)
+├── .claude-personal/          # Account: personal (auto-created)
+└── .claude-<name>/            # Account: <name>
+```
+
+---
+
+## Documentation
+
+- **[Installation Guide](docs/installation.md)** — setup for all platforms
+- **[Usage Guide](docs/usage.md)** — full walkthrough of every feature
+
+---
+
+## Requirements
+
+- [Claude CLI](https://docs.anthropic.com/en/docs/claude-code) installed and available in PATH
+- **Windows**: PowerShell 5.1+
+- **Linux/macOS**: Bash 4+, `jq` for JSON merging
+
+---
+
+## Contributing
+
+Contributions are welcome! Feel free to open an issue or submit a pull request.
+
+---
+
+## Credits
+
+Built by **[Gyanesh Kumar](https://github.com/ghackk)**
+
+---
+
+## License
+
+[MIT](LICENSE)

package/bin/claude-multi.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+const { execSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+const rootDir = path.resolve(__dirname, '..');
+
+try {
+    if (os.platform() === 'win32') {
+        const script = path.join(rootDir, 'claude-menu.ps1');
+        execSync(`powershell -ExecutionPolicy Bypass -File "${script}"`, { stdio: 'inherit' });
+    } else {
+        const script = path.join(rootDir, 'unix', 'claude-menu.sh');
+        execSync(`bash "${script}"`, { stdio: 'inherit' });
+    }
+} catch (e) {
+    process.exit(e.status || 1);
+}

package/claude-menu.bat

@@ -0,0 +1,2 @@
+@echo off
+powershell -ExecutionPolicy Bypass -File "%USERPROFILE%\claude-accounts\claude-menu.ps1"