claude-multi
Back to home
// Changelog

Release history.

Every release, every change. From v0.1 to today.

26
Releases
57
Features added
34
Bugs fixed
Latest release

v0.11.1

Fixed4Changed1
Fixed4 entries
  • Existing instances can now pick up provider template changes. claude-multi doctor check spots model and structural environment values that differ from the current template, even when the stored migration version is current. Run claude-multi doctor fix to back up the instance settings and apply the update.
  • The GLM 5.3 mapping now reaches existing GLM instances. Model slots update to glm-5.3[1m]; a legacy MAX_OUTPUT_TOKENS=64000 becomes 128000; obsolete GLM auto-compaction overrides are removed. MiniMax instances still using the old 64K output limit move to 512K.
  • Provider detection now accepts endpoints with a trailing slash, so a valid edited GLM URL does not cause template sync to be skipped.
  • The TUI migration option and health warning no longer appear for a version mismatch with no work to do.
Changed1 entry
  • Migrations and the instance-details "Sync template" action now use the same provider environment sync code. Model and structural settings follow the current template. API keys and user-tuned values stay in place, except for documented legacy defaults that need an upgrade.

// Past releases25

v0.11.0
5 entries
Changed
  • GLM template updated for GLM-5.3: Opus and sonnet slots now use glm-5.3[1m] (sonnet follows Z.ai's official Claude Code example); haiku and small/fast stay on glm-5-turbo. GLM-5.2 and GLM-5.1 are no longer served on the GLM Coding Plan, and requests for them auto-route to GLM-5.3. MAX_OUTPUT_TOKENS raised from 64000 to 128000 to match the documented 128K max output of both models. Thinking can no longer be disabled on GLM-5.3 (reasoning_effort low/high/max); the template keeps high.
  • New points-based GLM Coding Plan pricing documented on the provider page and in the GLM-5.3 blog post. The legacy 3x peak / 2x off-peak multiplier model was discontinued for new users on 2026-07-30.
  • Model and context-window references updated across the provider docs, environment-variables guide, FAQ, providers table, and llms.txt.
Fixed
  • CI check-version job no longer fails when there is nothing new to publish. It now exits 0 on a skip (equal or older version) and relies on the should_publish output to gate publishing, so pushes without a version bump keep CI green.
v0.10.0
5 entries
Changed
  • GLM template moved to a three-tier model mapping: Opus slot now uses glm-5.2[1m], sonnet uses glm-5.1, haiku uses glm-5-turbo. The previous template put GLM-5.1 in opus and reused GLM-5-Turbo for both sonnet and haiku, so there was no real middle tier.
  • GLM-5.2 is the new opus-tier model with a 1,000,000-token context window, exposed through the [1m] model-name suffix. GLM-5.1 and GLM-5-Turbo are 200K models.
  • Removed the global CLAUDE_CODE_AUTO_COMPACT_WINDOW (131072) and CLAUDE_AUTOCOMPACT_PCT_OVERRIDE overrides from the GLM template. A single global window cannot fit a 1M model and two 200K models at once, so each tier now carries its own size: the [1m] suffix for GLM-5.2, and Claude Code's default 200K assumption for the other two, which matches their real limit.
  • Updated GLM model and context-window references across the provider docs, FAQ, environment-variables guide, and glossary to reflect the three models.
v0.9.0
3 entries
Changed
  • Kimi template updated with tiered model mapping: Opus slot now uses kimi-k2.7-code, sonnet uses kimi-k2.6, haiku uses kimi-k2.5. Previous template used kimi-k2.5 for all roles.
  • Kimi template context window corrected from 128K to 256K (matching actual model spec).
v0.8.2
6 entries
Added
  • Granular sync modes for plugins and skills: Replaced the binary auto-sync toggle (on/off) with three sync modes: auto (symlink entire directories, existing behavior), half-manual (symlink individual plugins/skills, new installs stay isolated), and full-manual (independent copy, no symlinks). Only downgrades are allowed: auto → half-manual → full-manual.
    • New CLI flags: --half-manual, --sync-mode <mode> on the add command.
    • auto-sync command now accepts: auto, half-manual, full-manual, on (legacy), off (legacy).
    • halfSyncPluginsAndSkills() in config.ts: converts whole-directory symlinks to real directories with individual item symlinks.
    • getSyncMode() resolves the effective mode from the new syncMode field, falling back to the deprecated autoSync boolean for backward compatibility.
    • canConvertSyncMode() and availableSyncModeConversions() in constants.ts enforce downgrade-only rule.
    • copyAllFromDefault() now accepts a SyncMode parameter instead of a boolean.
    • detectBrokenSymlinks() now detects broken individual symlinks inside real directories (half-manual mode), not just broken directory-level symlinks.
    • TUI ToggleAutoSync screen rewritten as Sync Mode screen with color-coded mode labels and available-downgrade display.
    • Instance info screen (ShowInstanceInfo) shows sync mode with color-coded labels instead of binary on/off.
    • plugin install/remove commands blocked when instance is in half-manual mode (individually symlinked plugins cannot be individually managed).
    • fix-symlinks command handles all three modes.
Changed
  • Responsive header with hamburger dropdown navigation: The docs site header now collapses into a hamburger menu on tablet/mobile viewports (< 60rem). A custom <nav-dropdown> web component handles open/close with keyboard escape, outside-click dismiss, and coordination with Starlight's mobile sidebar.
  • Sticky sidebar with CSS grid overlay: On desktop (≥ 72rem), the docs page uses a CSS grid where the sidebar and main content overlap in the same grid cell. The sidebar uses position: sticky so it scrolls with the page but stops at the bottom, never overlapping the site footer.
  • SSR site footer: A full-width site footer is now injected during Astro's SSR build via a Vite plugin, so it spans the full viewport without sidebar overlap. Includes product links, docs links, and version number.
  • Header spacing and navigation density adjusted for better visual balance.
  • Instance.autoSync field deprecated in favor of Instance.syncMode. Old configs with autoSync: false resolve to full-manual via getSyncMode().
v0.8.1
3 entries
Fixed
  • CLI build output moved from dist/ to build/: The CLI and Astro docs builds both output to dist/, causing the published npm package to contain the docs site HTML instead of cli.js. Global installs would fail with Module not found ... dist/cli.js. The CLI now builds to build/cli.js, eliminating the collision.
  • Updated bin/claude-multi.js to resolve ../build/cli.js instead of ../dist/cli.js.
  • Updated CI workflows (ci.yml, publish.yml) to verify build/cli.js instead of dist/cli.js.
v0.8.0
6 entries
Changed
  • MiniMax template updated from M2.7 to M3: All model slots now point to MiniMax-M3 (opus, sonnet, haiku, small/fast). M3 brings a 1M-token context window, frontier-level coding and agentic scores, native image/video input, and toggleable thinking.
  • Removed auto-compaction override from the MiniMax template. M3's 1M context window makes the 128K override unnecessary.
  • MiniMax template MAX_OUTPUT_TOKENS raised from 64K to 512K.
  • MiniMax template CLAUDE_CODE_EFFORT_LEVEL set to max.
  • MiniMax template description updated to reflect M3 capabilities.
v0.7.0
19 entries
Changed
  • Removed pinned Claude Code binary: claude-multi no longer installs its own copy of @anthropic-ai/claude-code into ~/.claude-multi/bin/. All instance wrappers now resolve to the user's globally installed claude binary via which claude/where claude. This means instances auto-update together with the global claude binary.
  • getClaudePath() in wrapper.ts simplified to two priorities: CLAUDE_MULTI_CLAUDE_PATH env override, then global PATH. The pinned binary check was removed.
  • doctor fix no longer installs a pinned Claude binary. It verifies claude is available in PATH and regenerates stale wrappers.
  • Health check for wrapper binary paths now compares against the resolved global claude path instead of PINNED_CLAUDE_BIN. Also gained a Windows .cmd regex pattern.
  • fixWrapperVersions() in health.ts rewritten to use tryGetClaudePath() instead of PINNED_CLAUDE_BIN.
  • Instance migration (v0.6.2) updated to use tryGetClaudePath() instead of the deleted tryGetGlobalClaudePath(). Added console.warn when claude binary is not found during wrapper regeneration.
  • TUNABLE_ENV_VARS local duplicate removed from migration.ts v0.6.3. Now imports the canonical set from constants/env.ts (was missing CLAUDE_CODE_AUTO_COMPACT_WINDOW and CLAUDE_AUTOCOMPACT_PCT_OVERRIDE).
  • PATH membership check in the add command uses path.dirname() and path.delimiter instead of Unix-specific lastIndexOf('/') and split(':').
  • where claude output split fixed to handle Windows \r\n line endings.
  • Version warning banner and isThirdPartyApiBroken check removed from the TUI (the affected versions are ancient).
Removed
  • PINNED_BIN_DIR and PINNED_CLAUDE_BIN constants from paths.ts.
  • COMPATIBLE_CLAUDE_VERSION, isThirdPartyApiBroken(), getPinnedBinaryVersion(), installPinnedClaude() from version.ts.
  • getGlobalClaudePath() and tryGetGlobalClaudePath() from wrapper.ts (became identical to getClaudePath() and tryGetClaudePath() after pinning removal).
  • ccVersion state, installFailed doctor result, and version warning banner from App.tsx.
Fixed
  • v0.6.3 migration TUNABLE_ENV_VARS local duplicate was missing two entries (CLAUDE_CODE_AUTO_COMPACT_WINDOW, CLAUDE_AUTOCOMPACT_PCT_OVERRIDE), causing auto-compaction settings to be overwritten with template defaults during migration.
  • Health check and doctor fix were fighting the v0.6.2 migration: migration set wrappers to global path, doctor overwrote them back to pinned binary. Both now use the same global path resolution.
  • where claude output on Windows was split on \n only, missing \r\n carriage returns.
  • add command PATH check was Unix-only (lastIndexOf('/') and split(':')).
  • Health check had no regex for Windows .cmd wrapper format.
v0.6.5
10 entries
Added
  • Instance details actions: The instance details screen now has action buttons. Press Enter on any instance to access: Update settings template, Update alias wrapper, and Override alias to standard. Each action shows a live mismatch indicator (✓ up to date, ⚠ mismatch detected, ✗ wrapper missing).
  • syncProviderTemplateForInstance() in config.ts — on-demand provider template sync for a single instance. Re-applies the latest template env vars while preserving API keys and user-customized tunable vars.
  • detectTemplateMismatch() and detectWrapperMismatch() in instance-diagnostics.ts — compare an instance's current settings/wrapper against the expected provider template.
  • TUNABLE_ENV_VARS shared constant in constants/env.ts — single source of truth for env vars that are preserved during template sync and excluded from staleness checks.
Changed
  • Health screen rewrite: Replaced static IssueCard list with a Select-based issue picker. Issues can now be selected, viewed in detail, and dismissed. Press Enter to view an issue, d to dismiss, D to dismiss all.
  • Post-migration stale state fixed: After running doctor fix, the health check warning no longer persists. The config is now reloaded before health checks re-run.
  • Migration lock staleness: Added a 30-minute staleness check to the migration lock file. Prevents stale locks from blocking migrations after crashes or PID reuse.
  • Atomic health status writes: saveHealthStatus() now uses write-to-temp + rename to prevent file corruption on crash or concurrent access.
  • Doctor fix guard: handleDoctorFix is now guarded against double-invocation from rapid keypresses.
  • Removed pre-existing TypeScript type errors in migration.ts v0.6.3 migration body (narrow Record type inference on newEnv).
v0.6.4
3 entries
Added
  • Instance migration (0.6.3) syncs provider template env vars to existing instances. Detects the provider from ANTHROPIC_BASE_URL in settings.json and re-applies the latest template (model names, thinking tokens, output limits). Preserves API keys and user-added env vars.
  • detectProvider() and getProviderByBaseUrl() in templates.ts match a base URL to a provider template name.
  • providerTemplate field on the Instance type. New instances store it; migration backfills it for existing instances.
v0.6.3
24 entries
Changed
  • Instance migrations regenerate wrappers pointing to the globally installed claude binary (via which claude), not the pinned binary at ~/.claude-multi/bin. Wrappers that already match the expected content are left untouched.
  • runMigration and createBackup are synchronous now (had no await expressions).
  • MiMo (pay-per-token and Token Plan) models bumped to mimo-v2.5-pro[1m] and mimo-v2.5[1m] (1M context window variants).
  • Kimi opus model changed from kimi-k2.6 to kimi-k2.5.
  • Provider templates now include explicit thinking and output token limits:
    • MiniMax: 32K thinking, 64K output
    • DeepSeek: 32K thinking, 128K output
    • MiMo (both plans): 128K output
    • Kimi: 16K thinking, 64K output
    • Qwen and Qwen Coding Plan: 16K thinking, 64K output
Added
  • getGlobalClaudePath() and tryGetGlobalClaudePath() in wrapper.ts resolve the claude binary from the env override or PATH, skipping the pinned binary.
  • Instance migration tests: fast-path skip on current-version instances, mixed instances (some current, some old), .claude.json updates when the wrapper file is missing, and a verification that regenerated wrappers contain the global claude path.
Fixed
  • Health test compared fixWrapperVersions output against generateWrapperScript() (resolves via env override) instead of buildWrapperScript(inst, PINNED_CLAUDE_BIN) (what the function actually uses). Would break if CLAUDE_MULTI_CLAUDE_PATH was set.
Added
  • Instances track the claude-multi version they were created with (createdWithVersion). New instances get the current version. Instances created before this field existed get 0.5 and show "before version tracking" in the UI.
  • doctor and the TUI health screen report when instance migrations are pending or when an instance is running an older version.
  • doctor fix shows which instances need migration and asks for confirmation before running.
  • Version column added to list, info, and the Ink TUI instance cards and detail screens.
Changed
  • instanceMigrationVersion in config now stores the actual package version rather than a separate numbering scheme.
  • The legacy sentinel ("0.5") is defined once as LEGACY_INSTANCE_VERSION and imported everywhere, instead of being hardcoded in multiple files.
  • Wrapper script template exists in a single place (buildWrapperScript in wrapper.ts). Migration and health check both delegate to it instead of duplicating the template string.
  • Instance migration only rewrites wrappers when the file content actually differs (version check + content diff), instead of unconditionally regenerating every wrapper.
  • fixWrapperVersions uses the canonical template targeting the pinned binary explicitly, with a content-diff check to avoid unnecessary writes.
Fixed
  • Removed broken compareVersions references from version.test.ts.
  • resolveClaudePath() in migration.ts used await in a non-async function (TypeScript error). Removed — replaced by generateWrapperScriptSafe from wrapper.ts.
  • Unused imports (COMPATIBLE_CLAUDE_VERSION, installPinnedClaude, getPinnedBinaryVersion, isThirdPartyApiBroken, PINNED_CLAUDE_BIN) removed from migration.ts.
  • config.ts loadConfig backfill loop now handles noUncheckedIndexedAccess correctly (pre-existing TypeScript error).
  • createBackup changed from async to sync (had no await expressions — pre-existing lint warning).
  • Array .sort() / .reverse() calls in migration.ts and config.ts changed to .toSorted() / .toReversed() (pre-existing lint warnings).
  • Duplicate existsSync import in test/wrapper.test.ts merged into single import.
v0.6.1
5 entries
Changed
  • Pinned Claude version updated from 2.1.153 to 2.1.156. isThirdPartyApiBroken() now covers v2.1.154 through v2.1.155.
  • Auto-updates re-enabled. PROVIDER_COMMON_ENV no longer injects DISABLE_AUTOUPDATER/DISABLE_UPDATES. autoUpdates set to true in instance state.
  • doctor fix now reinstalls the pinned binary when its version differs from COMPATIBLE_CLAUDE_VERSION, not just when broken. Covers the upgrade path from the old v2.1.153 pin.
  • Unknown CLI subcommands exit with an error instead of falling through to the Ink TUI.
  • All version pinning and compatibility code tagged with [SAFE PARK] comments for easy discovery and reactivation.
v0.6.0
8 entries
Added
  • doctor fix auto-installs pinned Claude binary: when the compatible binary at ~/.claude-multi/bin is missing or running an incompatible version, doctor fix now installs Claude Code v2.1.156 (the version that fixed the 3rd-party API breakage from v2.1.154–v2.1.155) before fixing wrappers. Works from both CLI and TUI.
  • Version verification on pinned binary: getPinnedBinaryVersion() reads the installed version and triggers a reinstall if it's v2.1.154–v2.1.155.
  • COMPATIBLE_CLAUDE_VERSION constant (src/version.ts): single source of truth for the pinned version (2.1.156).
  • PINNED_CLAUDE_BIN in src/paths.ts: shared path constant (previously duplicated in wrapper.ts and health.ts).
Changed
  • Global version banner: now reads "Run 'claude-multi doctor fix' to install a compatible version" instead of the passive "wait for a fix" message.
  • TUI "Fix wrappers" action: installs the pinned binary first if missing, then fixes wrappers. Both the menu option and the f key in the health screen follow this flow.
  • Wrapper scripts now use pinned binary by default: getClaudePath() checks ~/.claude-multi/bin before falling back to global which claude, so new instances automatically use the compatible version.
Fixed
  • Tests: integration tests updated for current version and help output.
v0.5.8
4 entries
Added
  • Region selection for MiMo Token Plan (--region): mimo-token provider now supports regional endpoints — China (cn), Singapore (sgp), Europe (ams). Users are prompted to pick a region after selecting mimo-token in all three entry points (CLI --region flag, interactive prompts, Ink TUI wizard). Defaults to cn for backward compatibility.
  • API key prefix mapping (API_KEY_PREFIXES): mimo-token shows tp_... placeholder in the API key input; all other providers show sk-.... Extensible map for future providers with non-standard key formats.
Changed
  • --provider error message (src/cli.ts): unknown provider error now dynamically lists all available providers instead of hardcoding three names.
  • Region advisory: both the interactive prompts and Ink TUI display a highlighted message reminding users to check their Xiaomi account console for the correct region.
v0.5.7
3 entries
Added
  • Provider templates (src/templates.ts): five new AI provider templates
    • Xiaomi MiMo (mimo): MiMo-V2.5-Pro and MiMo-V2.5 via xiaomimimo.com, pay-per-token API
    • Xiaomi MiMo Token Plan (mimo-token): MiMo-V2.5-Pro via xiaomimimo.com subscription; replace base URL with your regional endpoint (CN/SG/EU) from the subscription console
    • Moonshot Kimi (kimi): Kimi K2.6 (opus) and Kimi K2.5 (sonnet/haiku) via moonshot.ai, pay-per-token
    • Alibaba Qwen (qwen): Qwen3-Coder-Next/Plus/Flash via Alibaba DashScope, pay-per-token API
    • Alibaba Qwen Coding Plan (qwen-coding): Qwen3-Coder-Next/Plus/Flash via DashScope Coding Plan subscription
Changed
  • GLM template (glm): display name updated to "GLM Coding Plan"; description now clarifies the Anthropic endpoint is coding-plan-only (standard Z.ai pay-per-token API has no Anthropic-compatible URL)
  • Kimi template (kimi): sonnet/haiku tiers use kimi-k2.5 instead of kimi-k2.6, same family, ~37% cheaper; legacy K2 series EOL'd May 25 2026
v0.5.6
6 entries
Added
  • robots.txt route (src/web/pages/robots.txt.ts): serves sitemap reference and user-agent directives for the docs site
Changed
  • Runtime-agnostic launcher (bin/claude-multi.js): polyglot bin entry is simultaneously valid POSIX sh and ESM JavaScript
    • On Linux/macOS: shell shebang detects bun/node/deno and execs the correct runtime
    • On Windows + bun global install: bun's .exe shim reads the .js extension and runs directly as ESM, no /bin/sh lookup required
    • On Windows + npm install: npm's .cmd shim calls node on the .js file
    • Shebang changed to #!/usr/bin/env bun so bun's Windows shim can resolve itself in PATH
CI
  • Add cross-platform install verification workflow covering bun, node, and deno on Linux, Windows, and macOS
  • Separate build into its own job; test jobs download the artifact instead of rebuilding
  • Publish workflow now includes version bump step and enhanced post-publish verification
  • Add ci:test-install script to trigger the install-verification workflow from local
v0.5.5
15 entries
Added
  • Runtime detection (src/util/runtime.ts): detectPackageManager() identifies the active package manager (bun / npm / pnpm / deno) at runtime
Changed
  • Cross-runtime support: all package-manager operations (upgradeClaudeMulti, getCurrentVersion, updateClaudeCode) now use the detected package manager instead of hard-coding bun commands
  • getLatestVersion() replaced bun pm npm view with a direct fetch() to the npm registry, works in any runtime
  • getDefaultBinaryPath() selects the correct global bin directory for the active package manager on Windows (was always %LOCALAPPDATA%\bun\bin)
  • Generated wrapper shebang changed from #!/usr/bin/env bun to #!/usr/bin/env node
  • Default action (no subcommand) always launches the Ink TUI and awaits waitUntilExit(), the CLAUDE_MULTI_INK=false prompts fallback is removed
  • Update check is now opt-in: set CLAUDE_MULTI_UPDATE_CHECK=true to enable; it no longer runs on every invocation
  • Removed interactive / i command alias (default action covers this)
Fixed
  • AddInstance provider selection: choosing "None" now correctly resets selectedProvider to null and sets useProvider to false; choosing a provider correctly sets useProvider to true
  • getCurrentVersion() handles pnpm's array-shaped JSON response
CI
  • Publish workflow: skip git tag creation when the tag already exists remotely
  • Publish workflow: make git tagging optional via workflow input
  • Switch publish workflow from bun to npm with OIDC trusted publishing (no token)
  • Update Node.js to 24.x in CI and deployment workflows
  • Add ci:publish script to trigger versioned publish from local
v0.5.1
1 entry
Changed
  • Interactive-first launch: Running claude-multi with no arguments now opens the Ink TUI directly instead of printing help text
    • CLI subcommands (add, remove, list, etc.) continue to work as before
    • --help and --version flags are unaffected
    • CLAUDE_MULTI_INK=false still falls back to the prompts-based interactive mode
v0.5.0
32 entries
Added
  • Ink-based Interactive UI: Full terminal UI built with Ink + React
    • Home screen with instance list, menu, and health warning banner
    • Animated components: Header, StatusBar, StepIndicator, InstanceCard, IssueCard, WarningBanner
    • Screens: AddInstance, RemoveInstance, ShowInstanceInfo, ToggleAutoSync, FixSymlinks, HealthScreen, ManagePlugins, ManageMcp, ListInstances
    • Keyboard navigation: arrow keys, Enter, ESC, ! for health, q to quit
    • useConfig, useNavigation, useHealthCheck, useAnimations hooks
  • Per-Instance Plugin Management: Granular plugin control per instance
    • PluginInfo interface with id, name, category (internal/external), hasMcp, mcpServerNames, enabled, isSymlink
    • scanPluginsFromDir() discovers plugins from both plugins/ and external_plugins/ subdirs
    • listDefaultPlugins() / listInstancePlugins() for querying available and installed plugins
    • copySinglePlugin() / copySelectedPlugins() for individual or batch install with rollback
    • removeSinglePlugin() with rename-to-backup safety pattern
    • detectMcpCollisions() to check MCP server name conflicts before install
    • validatePluginOperation() pre-flight checks (configDir, symlink, plugin existence, collisions)
    • Handles 12 internal LSP plugins without plugin.json (falls back to dir name)
    • Supports both flat {"serverName": config} and nested {"mcpServers": {"serverName": config}} .mcp.json formats
    • Coordinates with installed_plugins.json v2 format (scope, installPath, version, timestamps)
    • Symlink detection: refuses per-plugin operations when auto-sync is active
  • Migration System (src/migration.ts): Safe v1 → v2 config upgrade
    • runMigration() with 4-step procedure: backup → validate → transform → save
    • PID-based lock file prevents concurrent migrations
    • Automatic backup of config.json + instance settings.json (keeps last 3)
    • Failure flag: sets migrationStatus: "failed" with error details, prevents auto-retry
    • clearMigrationFailure() for explicit retry
    • CLAUDE_MULTI_HOME env override for testability
  • Health Check System (src/health.ts): Detects and reports issues
    • Checks: migration failure, missing configDir, missing binary, corrupted settings.json, broken symlinks
    • Persistent health status at ~/.claude-multi/health-status.json
    • dismissIssue() / dismissAllIssues() for acknowledging warnings
    • Warning banner on home screen with ! key to review
    • HealthScreen with list/detail views, retry, dismiss actions
  • ManagePlugins Screen: Full plugin management UI
    • Install plugins from default (MultiSelect with MCP badge, [ext] tag)
    • Remove installed plugins
    • Enable/disable plugins
    • List installed plugins with status indicators
    • Symlink detection with warning
  • ManageMcp Screen: Enhanced MCP server management
    • List MCP servers with source attribution ([pluginName] or [custom])
    • Add custom MCP server (name + JSON config input)
    • Remove custom MCP server (select from custom servers)
    • Verify MCP configuration
    • Copy between instances
  • CLI Plugin Commands: 5 new plugins sub-commands
    • plugins install <instance> <ids...>, install plugins with collision detection
    • plugins remove <instance> <ids...>, remove plugins with symlink guard
    • plugins list-defaults, list all 50 default plugins with category/MCP badges
    • plugins list-installed [instance], list installed plugins per instance
    • plugins check-collisions <instance> <ids...>, detect MCP name conflicts
  • Provider Templates: DeepSeek provider template added
  • Instance State: initializeInstanceState() creates .claude.json with hasCompletedOnboarding: true
  • Provider Env: mergeProviderEnv() integrates provider template env vars into instance settings
  • Screenshot Capture: scripts/capture-screens.tsx for automated UI screenshots
Changed
  • copyAllFromDefault() restored autoSync parameter for symlink-based plugin sync
  • syncPluginsAndSkills() creates actual symlinks instead of copying files
  • Broken symlink detection uses lstatSync (works when existsSync returns false)
  • ~/.claude is strictly read-only, never modified by any operation
  • Atomic file writes for both config.json and settings.json (temp-file-rename pattern)
  • Lazy path resolution in migration.ts and health.ts for testability
Fixed
  • syncPluginsAndSkills was doing recursive copy instead of creating symlinks
  • copyAllFromDefault autoSync parameter was removed, breaking symlink-based sync
  • Broken symlinks not cleaned before creating new ones (used lstatSync instead of existsSync)
  • isClaudeCodeRunning() blocked tests, skips in NODE_ENV=test
  • writeFileSync not imported in config.ts
  • McpSourceDetails prop name mismatch in ManageMcp
  • renameSync dynamic import in saveConfigAtomic replaced with top-level import
  • TypeScript: updateInstanceAutoSync object possibly undefined after bounds check
Tests
  • 155 tests, 0 failures across 16 test files
  • test/plugin-management.test.ts (18 tests): scanning, copy, remove, MCP helpers, atomic writes
  • test/e2e/plugin-flow.test.ts (6 tests): CLI plugin operations end-to-end
  • test/migration.test.ts (15 tests): migration, backup, lock, failure recovery
  • test/health.test.ts (15 tests): health checks, persistence, dismiss
  • test/ink/ (31 tests): component rendering, screen navigation, animation hooks
  • test/config.test.ts (53 tests): sync/unsync, copyAllFromDefault, symlink cycles
v0.4.3
7 entries
Added
  • Broken Symlink Detection: Automatically detect and fix broken symlinks
    • New isBrokenSymlink() and detectBrokenSymlinks() functions
    • Auto-fix broken symlinks when creating or updating instances
    • Handles edge cases: broken symlinks, existing directories, incorrect symlink targets
  • fix-symlinks Command: Fix broken symlinks for existing instances
    • Interactive instance selection with multi-select support
    • --all flag to fix all instances at once
    • Auto-fixes instances with auto-sync enabled, warns for manual mode
    • Clear status indicators for broken symlinks vs. valid symlinks
  • Interactive Re-sync: Added "Re-sync symlinks" option to interactive mode menu
    • Quick access to symlink diagnosis and repair from interactive UI
  • Test Suite: Comprehensive tests for symlink detection and fixing
    • Tests for broken symlink detection
    • Tests for valid symlink handling
    • Tests for mixed scenarios (broken + valid symlinks)
    • Error handling tests for non-existent paths
Fixed
  • Symlink creation now uses lstatSync for proper broken symlink detection
  • Previously, existsSync() returned false for broken symlinks, preventing detection
  • Now correctly identifies and repairs broken symlinks in all scenarios
v0.4.2
2 entries
Fixed
  • Auto-sync symlinks now use absolute paths instead of relative paths
    • Previously used hardcoded ../../.claude/ which assumed instances were in ~/.claude-instances/
    • Now uses homedir() to resolve absolute paths, working for any instance location
    • Fixes broken symlinks when instances are created directly in home directory (e.g., ~/.claude-tester/)
Added
  • Symlink test suite to verify both relative and absolute symlink behaviors
v0.4.1
3 entries
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)
v0.4.0
6 entries
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
v0.3.0
4 entries
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
v0.2.0
9 entries
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
v0.1.0
13 entries
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

Want to follow along between releases?

View on GitHubGet started