claude-multi 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2025-01-XX
+
+### Added
+- **Windows Support**: Full cross-platform support for Windows
+  - Generates `.cmd` batch wrapper scripts on Windows
+  - Uses `where` command instead of `which` on Windows
+  - Default binary path set to `%APPDATA%\npm` on Windows
+  - Skips Unix-specific `chmod` operations on Windows
+- **Cross-platform CI**: GitHub Actions now tests on Ubuntu, Windows, and macOS
+- **Platform Documentation**: Added platform-specific notes and Windows PATH setup guide
+- **Test Suite**: Added comprehensive tests for wrapper script generation on all platforms
+
+### Changed
+- Binary naming convention: Windows wrappers now use `.cmd` extension (e.g., `claude-test.cmd`)
+- Improved `getClaudePath()` to handle platform-specific path detection
+- Enhanced wrapper generation to create appropriate script types per platform
+
+### Fixed
+- TypeScript strict null checks in config.ts
+- Windows compatibility issues with shebang and chmod operations
+
+## [0.1.0] - 2025-01-XX
+
+### Added
+- Initial release
+- Basic instance management (add, remove, list, info)
+- Wrapper script generation for multiple Claude Code instances
+- Interactive and non-interactive modes for creating instances
+- Settings and config copying from default Claude installation
+- MCP (Model Context Protocol) server configuration support
+- Version checking and update commands
+- CI/CD workflows for automated testing and npm publishing
+
+### Features
+- Create isolated Claude Code instances with custom aliases
+- Copy settings, plugins, and MCP configurations between instances
+- Manage multiple instances simultaneously
+- Support for custom config and binary paths
+- Command-line interface built with Commander.js
+
+[0.2.0]: https://github.com/hmziqrs/claude-multi/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/hmziqrs/claude-multi/releases/tag/v0.1.0

package/README.md

@@ -0,0 +1,242 @@
+# claude-multi
+
+> Manage multiple Claude Code instances with different aliases and configurations
+
+## Why?
+
+Claude Code supports multiple AI providers (Anthropic, GLM, Minimax), but switching between them requires manually editing config files. **claude-multi** solves this by creating isolated instances with different aliases and config paths.
+
+## Features
+
+- 🔄 **Multiple Instances**: Run different Claude Code configs simultaneously
+- 🎯 **Simple CLI**: Easy-to-use commands for managing instances
+- 🔒 **Isolated Configs**: Each instance has its own settings and history
+- ✅ **Legal**: Uses wrapper scripts, no code modification
+- 🚀 **Auto-sync**: Always uses the latest official Claude Code
+
+## Installation
+
+```bash
+# Install dependencies
+bun install
+
+# Build the project
+bun run build
+
+# Install globally (optional)
+npm link
+```
+
+### Windows Setup
+
+On Windows, ensure `%APPDATA%\npm` is in your PATH to use the wrapper commands:
+
+```cmd
+# Check if npm directory is in PATH
+echo %PATH%
+
+# Add to PATH if needed (PowerShell as Administrator)
+[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:APPDATA\npm", "User")
+```
+
+After adding to PATH, restart your terminal for changes to take effect.
+
+## Usage
+
+### Create instances
+
+```bash
+# Create instance (interactive - prompts for copying settings)
+claude-multi add glm
+
+# Create instance with custom config path
+claude-multi add work --config ~/configs/claude-work
+
+# Create instance with custom binary path
+claude-multi add minimax --binary ~/.local/bin/claude-minimax
+
+# Non-interactive modes
+claude-multi add glm --copy-settings      # Copy only settings.json
+claude-multi add glm --copy-all           # Copy all files (settings, CLAUDE.md, plugins)
+claude-multi add glm --skip-prompts       # Start fresh, no prompts
+```
+
+**Interactive prompt options:**
+- **Nothing - start fresh**: Empty config directory
+- **Only settings.json**: Copy your settings (API keys, preferences)
+- **All files**: Copy settings, CLAUDE.md, plugins, etc. (excludes history, debug logs)
+
+### Use instances
+
+Each instance gets its own command:
+
+```bash
+claude-glm       # Uses ~/.claude-glm config
+claude-work      # Uses ~/configs/claude-work
+claude-minimax   # Uses ~/.claude-minimax config
+claude           # Original command, uses ~/.claude
+```
+
+### Manage instances
+
+```bash
+# List all instances
+claude-multi list
+
+# Show instance details
+claude-multi info glm
+
+# Remove instance
+claude-multi remove glm
+
+# Remove without confirmation
+claude-multi remove glm --force
+```
+
+### Version management
+
+```bash
+# Check for updates
+claude-multi version
+
+# Update Claude Code to latest
+claude-multi update
+```
+
+## How It Works
+
+`claude-multi` creates wrapper scripts that set the `CLAUDE_CONFIG_DIR` environment variable before calling the original `claude` binary:
+
+```javascript
+#!/usr/bin/env node
+process.env.CLAUDE_CONFIG_DIR = "/Users/you/.claude-glm"
+import("/usr/local/bin/claude")
+```
+
+This approach:
+- ✅ Doesn't modify Anthropic's code (legal)
+- ✅ Uses official Claude Code (no forking)
+- ✅ Auto-syncs with upstream (no version tracking needed)
+- ✅ Simple and maintainable
+
+## Use Cases
+
+### Personal + Work
+```bash
+claude-multi add personal
+claude-multi add work
+
+claude-personal  # Personal projects
+claude-work      # Work projects
+```
+
+### Paid + Free Providers
+```bash
+claude-multi add anthropic  # Paid subscription
+claude-multi add glm        # Free GLM API
+
+claude-anthropic  # High-quality, paid
+claude-glm        # Free tier
+```
+
+### Multiple Environments
+```bash
+claude-multi add prod
+claude-multi add staging
+claude-multi add dev
+
+# Different configs for each
+```
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run in dev mode
+bun run dev
+
+# Build
+bun run build
+
+# Test
+bun run dev add test --binary ./test-bin/claude-test
+bun run dev list
+bun run dev remove test --force
+```
+
+## Requirements
+
+- Node.js >= 18
+- Bun (for development)
+- `@anthropic-ai/claude-code` installed globally
+
+## Platform Support
+
+**claude-multi** supports all major operating systems:
+
+- ✅ **Linux**: Fully supported
+- ✅ **macOS**: Fully supported  
+- ✅ **Windows**: Fully supported
+
+### Platform-Specific Notes
+
+**Windows:**
+- Wrapper scripts are created as `.cmd` batch files
+- Binary path defaults to `%APPDATA%\npm`
+- Example: `claude-glm.cmd` instead of `claude-glm`
+
+**Unix/Linux/macOS:**
+- Wrapper scripts are Node.js scripts with shebangs
+- Binary path defaults to `~/.local/bin`
+- Scripts are automatically marked as executable
+
+## Project Structure
+
+```
+claude-multi/
+├── src/
+│   ├── cli.ts       # Main CLI interface
+│   ├── config.ts    # Instance config management
+│   ├── wrapper.ts   # Wrapper script generation
+│   └── version.ts   # Version checking
+├── docs/
+│   └── raw-plan.md  # Detailed implementation plan
+├── package.json
+└── README.md
+```
+
+## Configuration
+
+Instance metadata is stored in `~/.claude-multi/config.json`:
+
+```json
+{
+  "instances": [
+    {
+      "name": "glm",
+      "configDir": "/Users/you/.claude-glm",
+      "binaryPath": "/usr/local/bin/claude-glm",
+      "createdAt": "2025-11-02T03:57:41.000Z"
+    }
+  ],
+  "version": "1.0.0"
+}
+```
+
+## CI/CD
+
+- **CI**: Runs on PRs and pushes to master (Node 20.x)
+- **Publish**: Auto-publishes to npm when version tags are pushed
+- **Requirements**: `NPM_TOKEN` secret configured in GitHub
+
+## License
+
+MIT
+
+## Credits
+
+Built with [Bun](https://bun.sh) and [Commander.js](https://github.com/tj/commander.js)
+
+Wrapper for [@anthropic-ai/claude-code](https://www.npmjs.com/package/@anthropic-ai/claude-code)

package/ROADMAP.md

@@ -0,0 +1,104 @@
+# Claude Multi - Project Roadmap
+
+## Overview
+Claude Multi is a CLI tool for managing multiple Claude Code instances with different aliases and configurations. This roadmap outlines planned features and improvements.
+
+## ✅ Completed Features
+
+### Cross-Platform Support (v0.2.0)
+**Status**: ✅ Completed
+
+- **Windows Support**: Full support for Windows platform
+  - `.cmd` batch wrapper generation
+  - Platform-specific path detection (`where` vs `which`)
+  - Proper handling of Windows-specific paths (`%APPDATA%\npm`)
+  - Skip Unix-specific operations (chmod) on Windows
+
+- **macOS Support**: Full support for macOS platform
+  - Native shebang-based wrapper scripts
+  - `~/.local/bin` default path
+
+- **Linux Support**: Full support for Linux distributions
+  - Native shebang-based wrapper scripts
+  - `~/.local/bin` default path
+
+- **Cross-Platform CI**: GitHub Actions testing on all three platforms
+- **Test Coverage**: Comprehensive unit tests for platform-specific behavior
+
+## 🚀 Priority Features
+
+### 1. Basic Backup & Restore
+**Goal**: Simple way to export/import configs without ongoing sync maintenance
+
+#### Features:
+- **Archive Export/Import**:
+  ```bash
+  claude-multi backup export <file.tar.gz>    # Archive selected instances + metadata
+  claude-multi backup import <file.tar.gz>    # Restore into local config dirs
+  ```
+- **Scope**: Local archives only; no cloud providers, encryption, or auto-sync
+- **Manifest**: Include a small JSON manifest describing included instances
+
+### 2. Enhanced Interactive Mode
+**Goal**: More powerful and user-friendly interactive interface
+
+#### Features:
+- **Simplified Interface**:
+  - Clean list view of all instances
+  - Basic status indicators
+  - Easy navigation without complex filtering
+
+## 🔧 Quality of Life Improvements
+
+### 3. Shell Integration
+**Goal**: Seamless terminal experience
+
+#### Features:
+- **Auto-completion**:
+  - Bash/Zsh completion scripts
+  - Context-aware suggestions
+  - Instance name completion
+
+- **Shell Aliases**:
+  - Quick access to favorite instances
+  - Custom shortcuts for common operations
+  - Environment-specific configurations
+
+- **Prompt Integration**:
+  - (Future consideration) Optional prompt snippet showing last used instance
+
+### 4. Configuration Management
+**Goal**: Advanced configuration handling
+
+#### Features:
+- **Global Defaults**:
+  - Preferred paths and settings
+  - Environment-specific overrides
+
+- **Validation**:
+  - Configuration schema validation
+  - Cross-instance consistency checks
+  - Migration guides for breaking changes
+
+- **Settings Inheritance**:
+  - Global settings inheritance
+  - Instance-specific customizations
+
+## 🔧 Technical Considerations
+
+### Configuration Storage
+- Keep config JSON lean; validate shape before save
+- Use atomic writes when updating config metadata
+
+### Performance
+- Keep operations synchronous and fast; avoid premature abstractions
+- Only load instance details when needed in interactive mode
+
+### Error Handling
+- Graceful degradation for missing dependencies
+- Clear error messages with suggested fixes
+- Prefer manual fixes over automatic mutation of user files
+
+### Security
+- Respect CLAUDE_CONFIG_DIR permissions; do not handle secrets directly
+- Leave credential storage to Claude Code

package/bun.lock

@@ -0,0 +1,77 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 0,
+  "workspaces": {
+    "": {
+      "name": "cc-forks",
+      "dependencies": {
+        "chalk": "^5.3.0",
+        "commander": "^12.0.0",
+        "prompts": "^2.4.2",
+      },
+      "devDependencies": {
+        "@types/node": "^20.0.0",
+        "@types/prompts": "^2.4.9",
+        "bun-types": "latest",
+      },
+      "peerDependencies": {
+        "@anthropic-ai/claude-code": ">=2.0.0",
+      },
+    },
+  },
+  "packages": {
+    "@anthropic-ai/claude-code": ["@anthropic-ai/claude-code@2.0.31", "", { "optionalDependencies": { "@img/sharp-darwin-arm64": "^0.33.5", "@img/sharp-darwin-x64": "^0.33.5", "@img/sharp-linux-arm": "^0.33.5", "@img/sharp-linux-arm64": "^0.33.5", "@img/sharp-linux-x64": "^0.33.5", "@img/sharp-win32-x64": "^0.33.5" }, "bin": { "claude": "cli.js" } }, "sha512-UiWopkOqZD5EHoDa8jmkT4AOVtvGWjfCOZ+hGlDqbBY5D0hia6kRDgizLsIvMRqnQr1pBAPCpyeWhH/WndaT/A=="],
+
+    "@img/sharp-darwin-arm64": ["@img/sharp-darwin-arm64@0.33.5", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-arm64": "1.0.4" }, "os": "darwin", "cpu": "arm64" }, "sha512-UT4p+iz/2H4twwAoLCqfA9UH5pI6DggwKEGuaPy7nCVQ8ZsiY5PIcrRvD1DzuY3qYL07NtIQcWnBSY/heikIFQ=="],
+
+    "@img/sharp-darwin-x64": ["@img/sharp-darwin-x64@0.33.5", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-x64": "1.0.4" }, "os": "darwin", "cpu": "x64" }, "sha512-fyHac4jIc1ANYGRDxtiqelIbdWkIuQaI84Mv45KvGRRxSAa7o7d1ZKAOBaYbnepLC1WqxfpimdeWfvqqSGwR2Q=="],
+
+    "@img/sharp-libvips-darwin-arm64": ["@img/sharp-libvips-darwin-arm64@1.0.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-XblONe153h0O2zuFfTAbQYAX2JhYmDHeWikp1LM9Hul9gVPjFY427k6dFEcOL72O01QxQsWi761svJ/ev9xEDg=="],
+
+    "@img/sharp-libvips-darwin-x64": ["@img/sharp-libvips-darwin-x64@1.0.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-xnGR8YuZYfJGmWPvmlunFaWJsb9T/AO2ykoP3Fz/0X5XV2aoYBPkX6xqCQvUTKKiLddarLaxpzNe+b1hjeWHAQ=="],
+
+    "@img/sharp-libvips-linux-arm": ["@img/sharp-libvips-linux-arm@1.0.5", "", { "os": "linux", "cpu": "arm" }, "sha512-gvcC4ACAOPRNATg/ov8/MnbxFDJqf/pDePbBnuBDcjsI8PssmjoKMAz4LtLaVi+OnSb5FK/yIOamqDwGmXW32g=="],
+
+    "@img/sharp-libvips-linux-arm64": ["@img/sharp-libvips-linux-arm64@1.0.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-9B+taZ8DlyyqzZQnoeIvDVR/2F4EbMepXMc/NdVbkzsJbzkUjhXv/70GQJ7tdLA4YJgNP25zukcxpX2/SueNrA=="],
+
+    "@img/sharp-libvips-linux-x64": ["@img/sharp-libvips-linux-x64@1.0.4", "", { "os": "linux", "cpu": "x64" }, "sha512-MmWmQ3iPFZr0Iev+BAgVMb3ZyC4KeFc3jFxnNbEPas60e1cIfevbtuyf9nDGIzOaW9PdnDciJm+wFFaTlj5xYw=="],
+
+    "@img/sharp-linux-arm": ["@img/sharp-linux-arm@0.33.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm": "1.0.5" }, "os": "linux", "cpu": "arm" }, "sha512-JTS1eldqZbJxjvKaAkxhZmBqPRGmxgu+qFKSInv8moZ2AmT5Yib3EQ1c6gp493HvrvV8QgdOXdyaIBrhvFhBMQ=="],
+
+    "@img/sharp-linux-arm64": ["@img/sharp-linux-arm64@0.33.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm64": "1.0.4" }, "os": "linux", "cpu": "arm64" }, "sha512-JMVv+AMRyGOHtO1RFBiJy/MBsgz0x4AWrT6QoEVVTyh1E39TrCUpTRI7mx9VksGX4awWASxqCYLCV4wBZHAYxA=="],
+
+    "@img/sharp-linux-x64": ["@img/sharp-linux-x64@0.33.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-x64": "1.0.4" }, "os": "linux", "cpu": "x64" }, "sha512-opC+Ok5pRNAzuvq1AG0ar+1owsu842/Ab+4qvU879ippJBHvyY5n2mxF1izXqkPYlGuP/M556uh53jRLJmzTWA=="],
+
+    "@img/sharp-win32-x64": ["@img/sharp-win32-x64@0.33.5", "", { "os": "win32", "cpu": "x64" }, "sha512-MpY/o8/8kj+EcnxwvrP4aTJSWw/aZ7JIGR4aBeZkZw5B7/Jn+tY9/VNwtcoGmdT7GfggGIU4kygOMSbYnOrAbg=="],
+
+    "@types/node": ["@types/node@20.19.24", "", { "dependencies": { "undici-types": "~6.21.0" } }, "sha512-FE5u0ezmi6y9OZEzlJfg37mqqf6ZDSF2V/NLjUyGrR9uTZ7Sb9F7bLNZ03S4XVUNRWGA7Ck4c1kK+YnuWjl+DA=="],
+
+    "@types/prompts": ["@types/prompts@2.4.9", "", { "dependencies": { "@types/node": "*", "kleur": "^3.0.3" } }, "sha512-qTxFi6Buiu8+50/+3DGIWLHM6QuWsEKugJnnP6iv2Mc4ncxE4A/OJkjuVOA+5X0X1S/nq5VJRa8Lu+nwcvbrKA=="],
+
+    "@types/react": ["@types/react@19.2.2", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-6mDvHUFSjyT2B2yeNx2nUgMxh9LtOWvkhIU3uePn2I2oyNymUAX1NIsdgviM4CH+JSrp2D2hsMvJOkxY+0wNRA=="],
+
+    "bun-types": ["bun-types@1.3.1", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-NMrcy7smratanWJ2mMXdpatalovtxVggkj11bScuWuiOoXTiKIu2eVS1/7qbyI/4yHedtsn175n4Sm4JcdHLXw=="],
+
+    "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
+
+    "commander": ["commander@12.1.0", "", {}, "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA=="],
+
+    "csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
+
+    "kleur": ["kleur@3.0.3", "", {}, "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w=="],
+
+    "prompts": ["prompts@2.4.2", "", { "dependencies": { "kleur": "^3.0.3", "sisteransi": "^1.0.5" } }, "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q=="],
+
+    "sisteransi": ["sisteransi@1.0.5", "", {}, "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg=="],
+
+    "undici-types": ["undici-types@6.21.0", "", {}, "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ=="],
+
+    "@types/prompts/@types/node": ["@types/node@24.9.2", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-uWN8YqxXxqFMX2RqGOrumsKeti4LlmIMIyV0lgut4jx7KQBcBiW6vkDtIBvHnHIquwNfJhk8v2OtmO8zXWHfPA=="],
+
+    "bun-types/@types/node": ["@types/node@24.9.2", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-uWN8YqxXxqFMX2RqGOrumsKeti4LlmIMIyV0lgut4jx7KQBcBiW6vkDtIBvHnHIquwNfJhk8v2OtmO8zXWHfPA=="],
+
+    "@types/prompts/@types/node/undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+
+    "bun-types/@types/node/undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+  }
+}