claude-multi 0.2.0 → 0.4.1

package/CHANGELOG.md

@@ -5,6 +5,60 @@ 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.4.1] - 2025-01-26
+
+### Added
+- **Test Suite**: Comprehensive sandboxing tests for auto-sync functionality
+  - 46 tests covering syncPluginsAndSkills, unsyncPluginsAndSkills, copySettingsFromDefault, and copyAllFromDefault
+  - Real file system operations in temporary directories with complete isolation
+  - AutoSyncTestHelper class for test utilities and assertions
+  - Test helper functions to override default Claude directory for testing
+  - Integration tests for sync/unsync cycles and auto-sync toggle
+
+### Fixed
+- macOS compatibility: Fixed rmSync usage to properly handle both symlinks and directories
+- Security: copySettingsFromDefault now uses whitelist approach to only copy safe settings (exclude sensitive data like env and mcpServers)
+
+[0.4.1]: https://github.com/hmziqrs/claude-multi/compare/v0.4.0...v0.4.1
+
+## [0.4.0] - 2025-01-26
+
+### Added
+- **Auto-Sync for Plugins and Skills**: Share plugins/skills across instances via symlinks
+  - New `--auto-sync` and `--manual` flags for `add` command
+  - Auto-sync enabled by default when copying all files
+  - `auto-sync <name> <on|off>` command to toggle for existing instances
+  - Interactive mode option to toggle auto-sync setting
+  - Instance info/list now display auto-sync status
+- **Bun Runtime Support**: Migrated from npm/node to Bun
+  - All npm commands replaced with bun equivalents
+  - Build target changed from node to bun
+  - Shebangs updated to use bun instead of node
+  - Windows binary path changed to `%LOCALAPPDATA%\bun\bin`
+
+### Changed
+- Plugins and skills directories now use symlinks by default (auto-sync mode)
+- When auto-sync is enabled, plugins/skills are symlinked from `~/.claude`
+- When auto-sync is disabled, files are copied to instance config directory
+
+### Fixed
+- Removed unused code and improved error handling
+
+## [0.3.0] - 2025-01-XX
+
+### Added
+- **Provider Templates**: Built-in templates for popular AI providers
+  - GLM (智谱AI) template with GLM-4.5-air and GLM-4.6 models
+  - MiniMax template with MiniMax-M2 model
+  - Interactive provider selection with secure API key prompt
+  - CLI flags: `--provider <name>` and `--api-key <key>`
+  - Auto-configuration of base URLs, model mappings, and optimal settings
+- **Quick Start Guide**: Added quick start section with provider template examples
+
+### Changed
+- Interactive mode now prompts for provider templates before config copying
+- Enhanced instance creation flow with provider-first approach
+
 ## [0.2.0] - 2025-01-XX
 
 ### Added
@@ -45,5 +99,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for custom config and binary paths
 - Command-line interface built with Commander.js
 
+[0.3.0]: https://github.com/hmziqrs/claude-multi/compare/v0.2.0...v0.3.0
 [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

@@ -11,20 +11,36 @@ Claude Code supports multiple AI providers (Anthropic, GLM, Minimax), but switch
 - 🔄 **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
+- 🎨 **Provider Templates**: Built-in templates for GLM, MiniMax, and more
 - ✅ **Legal**: Uses wrapper scripts, no code modification
 - 🚀 **Auto-sync**: Always uses the latest official Claude Code
 
 ## Installation
 
 ```bash
-# Install dependencies
-bun install
+npm install -g claude-multi
+```
+
+## Quick Start
 
-# Build the project
-bun run build
+Get started with a provider template in 30 seconds:
 
-# Install globally (optional)
-npm link
+```bash
+# Create a GLM instance
+claude-multi add glm --provider glm --api-key "your-glm-api-key"
+
+# Use it!
+claude-glm --help
+```
+
+**Or use interactive mode:**
+
+```bash
+claude-multi add myinstance
+# Choose "Yes" when asked about provider templates
+# Select GLM or MiniMax
+# Enter your API key
+# Done!
 ```
 
 ### Windows Setup
@@ -46,9 +62,13 @@ After adding to PATH, restart your terminal for changes to take effect.
 ### Create instances
 
 ```bash
-# Create instance (interactive - prompts for copying settings)
+# Create instance (interactive - prompts for provider templates and copying settings)
 claude-multi add glm
 
+# Create instance with provider template (CLI mode)
+claude-multi add glm --provider glm --api-key "your-api-key-here"
+claude-multi add minimax --provider minimax --api-key "your-api-key-here"
+
 # Create instance with custom config path
 claude-multi add work --config ~/configs/claude-work
 
@@ -61,11 +81,18 @@ claude-multi add glm --copy-all           # Copy all files (settings, CLAUDE.md,
 claude-multi add glm --skip-prompts       # Start fresh, no prompts
 ```
 
+**Provider Templates:**
+- **GLM (智谱AI)**: GLM-4.5-air and GLM-4.6 models via z.ai
+- **MiniMax**: MiniMax-M2 model via minimax.io
+
 **Interactive prompt options:**
+- **Provider templates**: Choose GLM, MiniMax, or None/Custom
 - **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)
 
+When using a provider template, you'll be prompted to enter your API key securely.
+
 ### Use instances
 
 Each instance gets its own command:
@@ -103,22 +130,6 @@ claude-multi version
 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
@@ -130,13 +141,20 @@ claude-personal  # Personal projects
 claude-work      # Work projects
 ```
 
-### Paid + Free Providers
+### Different AI Providers
 ```bash
-claude-multi add anthropic  # Paid subscription
-claude-multi add glm        # Free GLM API
-
-claude-anthropic  # High-quality, paid
-claude-glm        # Free tier
+# Interactive mode with provider template
+claude-multi add anthropic  # Use Anthropic (prompted for API key)
+claude-multi add glm        # Use GLM template (prompted for API key)
+claude-multi add minimax    # Use MiniMax template (prompted for API key)
+
+# CLI mode with provider template
+claude-multi add glm --provider glm --api-key "sk-..."
+claude-multi add minimax --provider minimax --api-key "sk-..."
+
+claude-anthropic  # Uses Anthropic Claude
+claude-glm        # Uses GLM-4.6
+claude-minimax    # Uses MiniMax-M2
 ```
 
 ### Multiple Environments
@@ -148,28 +166,32 @@ claude-multi add dev
 # Different configs for each
 ```
 
-## Development
+## Provider Templates
 
-```bash
-# Install dependencies
-bun install
+Built-in templates for popular AI providers. Each template auto-configures the API endpoint, model mappings, and optimal settings.
+
+### Available Providers
+
+**GLM (智谱AI)**: GLM-4.5-air and GLM-4.6 models via `api.z.ai`
 
-# Run in dev mode
-bun run dev
+**MiniMax**: MiniMax-M2 model via `api.minimax.io`
 
-# Build
-bun run build
+### Usage
+
+```bash
+# CLI mode
+claude-multi add glm --provider glm --api-key "your-api-key"
 
-# Test
-bun run dev add test --binary ./test-bin/claude-test
-bun run dev list
-bun run dev remove test --force
+# Interactive mode
+claude-multi add myinstance
+# Select provider when prompted and enter API key
 ```
 
+Customize later by editing `~/.claude-{name}/settings.json`
+
 ## Requirements
 
 - Node.js >= 18
-- Bun (for development)
 - `@anthropic-ai/claude-code` installed globally
 
 ## Platform Support
@@ -192,45 +214,6 @@ bun run dev remove test --force
 - 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
@@ -240,3 +223,9 @@ MIT
 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)
+
+## Support
+
+For technical documentation, development setup, and contribution guidelines, see [development.md](development.md).
+
+For issues, questions, or feature requests, please visit the project's issue tracker.