claude-switch-profile 1.0.2 → 1.4.0

package/CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+All notable changes to `claude-switch-profile` are documented here.
+
+## [1.3.0] - 2026-03-28
+
+### Added
+- ✨ **Interactive profile selector** — Run `csp` with no arguments to get an arrow-key profile picker that launches isolated sessions. Supports ↑/↓/j/k navigation, Enter to select, Esc to cancel.
+- ✨ **`csp status`** — Dashboard showing active profile, profile count, last launch info, and Claude running status at a glance.
+- ✨ **`csp toggle`** — Quick-switch to the previous profile (like `cd -`). Uses isolated launch, never touches ~/.claude.
+- ✨ **`csp select`** — Explicit alias for the interactive selector.
+
+### Changed
+- 🔒 **`~/.claude` is never modified** — All profile operations now use isolated runtime (`CLAUDE_CONFIG_DIR`). The `default` profile is a virtual alias for `~/.claude` as-is.
+- 🔒 **`default` profile is virtual** — `csp init` no longer creates a physical directory for the default profile. Default means "use ~/.claude directly".
+- 🔒 **`csp launch default`** — Launches Claude with native `~/.claude` (no runtime dir, no `CLAUDE_CONFIG_DIR` override).
+- 🔒 **`csp deactivate`** — Now simply resets active marker to `default`. No longer deletes files from `~/.claude`.
+- ⚠️ **`csp use` deprecated** — Shows warning that it modifies `~/.claude` (legacy mode). Users should prefer `csp launch`.
+- 🔄 **`csp toggle`** — Now uses `launch` (isolated) instead of `use` (legacy).
+
+### Fixed
+- 🐛 Removed dead `--force` option from `csp use`.
+- 🐛 Fixed double `getActive()` call in `init` command.
+- 🐛 Fixed stale "symlink targets" comment in safety.js.
+- 🐛 Removed unused parameter in diff.js.
+
+---
+
+## [1.1.0] - 2026-03-13
+
+### Added
+- ✨ **`csp uninstall` command** — Cleanly remove CSP and restore a chosen profile to `~/.claude` before wiping all profile data. Supports `--force` and `--profile <name>` flags.
+
+### Changed
+- 🔄 **`saveSymlinks` now handles real dirs/files** — When a managed item in `~/.claude` is a real directory or file (not yet a symlink), `saveSymlinks` moves it into the profile directory and replaces it with a symlink in-place. Fixes the case where switching from a fresh `~/.claude` setup left the default profile empty.
+- 🔄 **`removeSymlinks` now removes real dirs/files** — Previously only removed symlinks; now also removes real directories and files for managed items so `createSymlinks` is never blocked.
+- 🔄 **`createSymlinks` uses `rmSync` instead of `unlinkSync`** — Correctly handles pre-existing directories (not just files/symlinks) when restoring a profile.
+
+### Fixed
+- 🐛 **`statusline.cjs` broken after switch to default profile** — `saveSymlinks` was copying the file into the profile directory, causing `require('./lib/...')` to fail because `lib/` does not exist there. Now the file stays as a symlink pointing to the source project.
+
+---
+
+## [1.0.2] - 2026-03-12
+
+### Fixed
+- 🐛 **`csp create` produces clean profiles** — New profiles no longer inherit the current session state; they start empty and isolated.
+
+### Changed
+- 🔄 **Max backups reduced to 2** — Keeps `.backup/` lean.
+
+---
+
+## [1.0.1] - 2026-03-11
+
+### Fixed
+- 🐛 Initial bug fixes after first release.
+
+---
+
+## [1.0.0] - 2026-03-11
+
+### Added
+- ✨ Initial release of `claude-switch-profile`
+- `csp init`, `csp create`, `csp use`, `csp save`, `csp list`, `csp current`
+- `csp delete`, `csp export`, `csp import`, `csp diff`
+- Symlink + copy strategy for isolating Claude Code profiles
+- Lock file, automatic backups, Claude process detection
+- Environment variable overrides (`CSP_HOME`, `CSP_CLAUDE_DIR`, `CSP_PROFILES_DIR`)

package/README.md

@@ -1,6 +1,10 @@
 # Claude Switch Profile (CSP)
 
-A CLI tool for managing multiple Claude Code configurations and profiles. Effortlessly switch between different development setups, each with their own rules, agents, skills, and settings.
+[![npm version](https://img.shields.io/npm/v/claude-switch-profile)](https://www.npmjs.com/package/claude-switch-profile)
+[![Node.js >= 18](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+A CLI tool for managing multiple Claude Code configurations and profiles. Use legacy global switching (`csp use`) or concurrent isolated account sessions (`csp launch`) with per-profile runtime roots.
 
 ## Overview
 
@@ -42,7 +46,8 @@ csp --help
 ### Requirements
 
 - Node.js >= 18.0.0
-- Unix/Linux/macOS (uses symlinks and POSIX tools)
+- Unix/Linux/macOS
+- Windows 10+
 
 ## Quick Start
 
@@ -104,13 +109,22 @@ csp list
 Output example:
 
 ```
- * default — Default profile (initial capture) (2026-03-11)
+ * default — Vanilla Claude defaults (2026-03-11)
    work — Work setup (2026-03-11)
    experimental (2026-03-11)
 ```
 
 The `*` marks the active profile.
 
+### 6. Uninstall CSP
+
+Remove CSP and restore your Claude Code to its original state:
+
+```bash
+csp uninstall
+# Uninstall CSP and remove all profiles? This cannot be undone. (y/N)
+```
+
 ## Commands Reference
 
 ### init
@@ -133,7 +147,7 @@ csp init
 
 ### current
 
-Display the currently active profile.
+Display the currently active **legacy** profile and isolated launch metadata (if present).
 
 ```bash
 csp current
@@ -141,8 +155,10 @@ csp current
 
 **Output:**
 ```
-✓ Active profile: default
+✓ Active legacy profile: default
 ℹ Location: /home/user/.claude-profiles/default
+ℹ Last isolated launch: 2026-03-26T14:45:00.000Z
+ℹ Isolated runtime: /home/user/.claude-profiles/.runtime/default
 ```
 
 ---
@@ -158,8 +174,8 @@ csp ls
 
 **Output format:**
 ```
- * profile-name — optional description (YYYY-MM-DD)
-   other-profile (YYYY-MM-DD)
+ * profile-name — optional description (YYYY-MM-DD) [legacy|account-session]
+   other-profile (YYYY-MM-DD) [account-session]
 ```
 
 The `*` marks the currently active profile.
@@ -213,7 +229,7 @@ csp save
 ```
 
 **Behavior:**
-- Captures all managed symlinks and files from `~/.claude`
+- Captures all managed items and files from `~/.claude`
 - Overwrites profile's `source.json` and file copies
 - Useful after modifying rules, settings, or other configuration
 - Requires active profile (run `csp create` if none exists)
@@ -231,7 +247,7 @@ csp use <name> [options]
 **Options:**
 - `--dry-run` — Show what would change without executing
 - `--no-save` — Skip saving current profile before switching
-- `--force` — Switch even if some symlink targets are missing
+- `--force` — Accepted for compatibility (current switch path does not block on target-link validation)
 
 **Examples:**
 
@@ -256,14 +272,13 @@ csp use legacy --force
 ```
 
 **Behavior:**
-1. Validates target profile exists and is valid
-2. (Optional) Validates symlink targets exist
+1. Validates target profile exists and profile structure is valid
+2. Refuses to switch while Claude Code is running (legacy/global switching mutates `~/.claude` directly)
 3. If active profile exists and `--no-save` is not set: saves current state
-4. Creates automatic backup at `~/.claude-profiles/.backup/`
-5. Removes all managed items from `~/.claude`
-6. Restores target profile's symlinks and files
-7. Updates active marker
-8. **Important:** Claude Code session must be restarted for changes to apply
+4. Removes managed items/files from `~/.claude` as needed
+5. Restores target profile configuration into `~/.claude`
+6. Updates active marker
+7. **Important:** Claude Code session must be restarted for changes to apply
 
 ---
 
@@ -326,7 +341,7 @@ csp export staging -o ~/backups/claude-staging.tar.gz
 
 **Behavior:**
 - Creates tar.gz archive of entire profile directory
-- Includes source.json (symlink targets) and all copied files
+- Includes `source.json` (managed item map) and copied profile files/directories
 - Useful for backup, sharing, or version control
 
 ---
@@ -390,7 +405,7 @@ csp diff current backup
 ```
 Comparing: staging ↔ production
 
-Symlink targets (source.json): identical
+Managed item map (source.json): identical
 
 File differences:
   settings.json — different
@@ -399,10 +414,118 @@ File differences:
 ```
 
 **Behavior:**
-- Compares `source.json` (symlink targets)
+- Compares `source.json` (managed item map)
 - Lists file presence and content differences
 - Shows which files differ and in which profile they exist
 
+---
+
+### deactivate
+
+Deactivate the currently active non-default profile and clear `.active` without switching to another profile.
+
+```bash
+csp deactivate
+```
+
+**Options:**
+- `--no-save` — Skip saving current profile state before deactivation
+
+**Behavior:**
+1. Exits early if no active profile or active profile is `default`
+2. Optionally saves active profile state
+3. Removes managed items/files from `~/.claude`
+4. Clears active marker
+
+---
+
+### launch (la)
+
+Launch an isolated Claude session for a profile. This does **not** change global active profile. All extra arguments are forwarded to `claude`.
+
+```bash
+csp launch <name> [claude-args...]
+csp la <name> [claude-args...]
+```
+
+**Options:**
+- `--legacy-global` — Use old behavior (`csp use <name>` then launch)
+
+**Examples:**
+
+Launch isolated session:
+```bash
+csp launch work
+```
+
+Launch isolated with Claude flags:
+```bash
+csp launch work --dangerously-skip-permissions
+csp la dev --model opus
+```
+
+Launch legacy/global mode:
+```bash
+csp launch work --legacy-global
+```
+
+**Behavior (default isolated mode):**
+1. Validates target profile exists
+2. Prepares per-profile runtime under `~/.claude-profiles/.runtime/<name>`
+3. Resolves effective allowlisted `ANTHROPIC_*` launch env (`ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL`, `ANTHROPIC_MODEL`) with precedence: `settings.json env` > profile `.env` allowlist > parent process env
+4. Strips inherited `CLAUDECODE`, inherited `CLAUDE_CONFIG_DIR`, and inherited `ANTHROPIC_*` before applying resolved allowlisted values
+5. Spawns `claude` with `CLAUDE_CONFIG_DIR=<runtimeDir>`
+6. Inherits stdin/stdout/stderr for interactive use
+7. Forwards Claude's exit code
+8. Keeps `.active` unchanged and never mutates global `~/.claude`
+
+`ANTHROPIC_*` keys currently in isolated launch scope:
+- `ANTHROPIC_AUTH_TOKEN`
+- `ANTHROPIC_BASE_URL`
+- `ANTHROPIC_MODEL`
+
+Set `CSP_DEBUG_LAUNCH_ENV=1` to print key-level launch diagnostics (sources only, values are never printed).
+
+---
+
+### uninstall
+
+Remove all profiles and restore Claude Code to its pre-CSP state.
+
+```bash
+csp uninstall
+```
+
+**Options:**
+- `-f, --force` — Skip confirmation prompt
+- `--profile <name>` — Restore a specific profile instead of the active one
+
+**Examples:**
+
+Uninstall with confirmation:
+```bash
+csp uninstall
+# Uninstall CSP and remove all profiles? This cannot be undone. (y/N)
+```
+
+Restore a specific profile during uninstall:
+```bash
+csp uninstall --profile production
+```
+
+Force uninstall without prompt:
+```bash
+csp uninstall --force
+```
+
+**Behavior:**
+1. Creates a final backup at `~/.claude-profiles/.backup/`
+2. Restores the active profile (or `--profile` choice) to `~/.claude`
+3. Removes `~/.claude-profiles/` entirely
+4. Prints reminder to run `npm uninstall -g claude-switch-profile`
+
+---
+
 ## How Profiles Work
 
 ### Profile Storage
@@ -411,10 +534,13 @@ Profiles are stored in `~/.claude-profiles/`:
 
 ```
 ~/.claude-profiles/
-├── .active                    # Current active profile name
-├── profiles.json              # Metadata for all profiles
+├── .active                    # Current active profile name (legacy use mode)
+├── profiles.json              # Metadata for all profiles (v2 schema)
+├── .runtime/                  # Isolated launch roots
+│   ├── work/
+│   └── personal/
 ├── default/
-│   ├── source.json           # Symlink targets
+│   ├── source.json           # Managed item map
 │   ├── settings.json         # Copied from ~/.claude
 │   ├── .env                  # Copied from ~/.claude
 │   ├── .ck.json              # Copied from ~/.claude
@@ -429,7 +555,7 @@ Profiles are stored in `~/.claude-profiles/`:
 
 ### What Gets Managed
 
-**Symlinked Items** (via `source.json`):
+**Managed Static Items** (via `source.json`):
 - `CLAUDE.md` — Project-specific Claude configuration
 - `rules/` — Development rules and guidelines
 - `agents/` — Agent scripts and configurations
@@ -440,35 +566,49 @@ Profiles are stored in `~/.claude-profiles/`:
 
 **Copied Files**:
 - `settings.json` — Editor settings
-- `.env` — Environment variables
-- `.ck.json` — Custom settings
-- `.ckignore` — Ignore patterns
+- `.env`, `.env.example` — Environment variables
+- `.ck.json`, `.ckignore` — Custom settings and ignore patterns
+- `.mcp.json`, `.mcp.json.example` — MCP configuration
+- `.gitignore` — Local ignore settings
 
 **Copied Directories**:
-- `commands/` — Custom commands
-- `plugins/` — Custom plugins
+- `commands/`, `plugins/` — Custom commands/plugins
+- `workflows/`, `scripts/` — Automation and workflow assets
+- `output-styles/`, `schemas/` — Output and schema assets
 
 **Never Touched** (runtime/session data):
 - `.credentials.json`
-- `projects/`
-- `backups/`
-- `cache/`, `debug/`, `telemetry/`
-- `history.jsonl`
-- `plans/`, `todos/`, `tasks/`
-- `agent-memory/`, `session-env/`
+- `projects/`, `sessions/`, `session-env/`, `ide/`
+- `cache/`, `paste-cache/`, `downloads/`, `telemetry/`, `debug/`, `statsig/`
+- `history.jsonl`, `metadata.json`, `stats-cache.json`, `active-plan`
+- `backups/`, `command-archive/`, `commands-archived/`
+- `plans/`, `todos/`, `tasks/`, `teams/`, `agent-memory/`, `file-history/`, `shell-snapshots/`
 - All other session-specific data
 
-### Symlink vs. Copy Strategy
+### Legacy vs Isolated Launch Modes
+
+CSP now supports two paths:
+
+- **Legacy global mode (`csp use`)**
+  - Mutates `~/.claude`
+  - Updates `.active`
+  - Preserves old behavior for existing scripts
+
+- **Isolated launch mode (`csp launch`)**
+  - Does not mutate `~/.claude`
+  - Does not change `.active`
+  - Creates/updates runtime root per profile at `~/.claude-profiles/.runtime/<name>`
+  - Launches Claude with `CLAUDE_CONFIG_DIR` pointing to that runtime root
+
+### Runtime Sync Policy (isolated launch)
 
-**Why symlinks for some items?**
-- Rules, agents, skills often live in external git repos
-- Multiple profiles may share the same rules/skills
-- Symlinks avoid duplication and keep everything in sync
+For each launch, CSP syncs static profile config into runtime root:
 
-**Why copies for others?**
-- Settings and env vars are environment-specific
-- Each profile needs its own independent configuration
-- Prevents accidental modifications from affecting other profiles
+- Managed items (`CLAUDE.md`, `rules`, `agents`, `skills`, `hooks`, statusline files, `.luna.json`)
+- Copied files (`settings.json`, `.env`, `.ck.json`, `.ckignore`, etc.)
+- Copied directories (`commands`, `plugins`, `workflows`, `scripts`, ...)
+
+Runtime/account continuity stays isolated per runtime root and is not globally swapped.
 
 ## Safety Features
 
@@ -500,7 +640,7 @@ Every profile switch creates a timestamped backup:
     └── ...
 ```
 
-Backups are kept indefinitely. You can manually restore by copying from backup directory.
+Backups are pruned automatically; CSP keeps only the 2 most recent backups. You can manually restore by copying from backup directory.
 
 ### Claude Process Detection
 
@@ -512,14 +652,19 @@ When switching profiles, CSP detects if Claude Code is running:
 
 **Important:** Changes only take effect after restarting Claude Code.
 
+### Windows Support
+
+Process detection uses `tasklist` instead of `pgrep` on Windows.
+
+Export/import commands use the built-in `tar.exe` available on Windows 10+.
+
 ### Validation
 
 Before switching, CSP validates:
 1. Target profile exists
 2. Profile structure is valid
-3. (Optional with `--force`) Symlink targets are accessible
 
-Use `--force` to proceed even if validation fails:
+`--force` is currently accepted for compatibility:
 
 ```bash
 csp use legacy --force
@@ -667,15 +812,11 @@ csp delete default
 rm ~/.claude-profiles/.lock
 ```
 
-### Symlink targets missing
+### Invalid profile structure
 
-**Warning:** `Some symlink targets are missing: rules/development-rules.md — missing target`
+**Error:** `Profile "name" is invalid: Missing source.json — no managed items defined`
 
-**Solution:** Either restore the missing files to their original location or use `--force`:
-
-```bash
-csp use production --force
-```
+**Solution:** Recreate the profile or import a valid profile archive.
 
 ### Changes not applying
 
@@ -699,6 +840,10 @@ npm run test:cli        # CLI integration tests
 npm run test:safety     # Safety feature tests
 ```
 
+### Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history and migration guidance.
+
 ### Project Structure
 
 ```
@@ -716,10 +861,15 @@ npm run test:safety     # Safety feature tests
 │   │   ├── delete.js
 │   │   ├── export.js
 │   │   ├── import.js
-│   │   └── diff.js
+│   │   ├── diff.js
+│   │   ├── launch.js
+│   │   ├── deactivate.js
+│   │   └── uninstall.js
 │   ├── constants.js              # Configuration constants
+│   ├── platform.js               # Cross-platform compatibility
 │   ├── profile-store.js          # Profile metadata management
-│   ├── symlink-manager.js        # Symlink operations
+│   ├── runtime-instance-manager.js # Isolated runtime sync
+│   ├── item-manager.js           # Managed item copy/move operations
 │   ├── file-operations.js        # File copy/restore operations
 │   ├── safety.js                 # Locking, backups, validation
 │   ├── profile-validator.js      # Profile validation

package/bin/csp.js

@@ -15,6 +15,12 @@ import { exportCommand } from '../src/commands/export.js';
 import { importCommand } from '../src/commands/import.js';
 import { diffCommand } from '../src/commands/diff.js';
 import { initCommand } from '../src/commands/init.js';
+import { uninstallCommand } from '../src/commands/uninstall.js';
+import { launchCommand } from '../src/commands/launch.js';
+import { deactivateCommand } from '../src/commands/deactivate.js';
+import { toggleCommand } from '../src/commands/toggle.js';
+import { statusCommand } from '../src/commands/status.js';
+import { selectCommand } from '../src/commands/select.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
@@ -24,7 +30,13 @@ const program = new Command();
 program
   .name('csp')
   .description('Claude Switch Profile — manage multiple Claude Code configurations')
-  .version(pkg.version);
+  .version(pkg.version)
+  .enablePositionalOptions();
+
+program
+  .command('select', { isDefault: true })
+  .description('Interactive profile selector (default when no command given)')
+  .action(selectCommand);
 
 program
   .command('init')
@@ -33,7 +45,7 @@ program
 
 program
   .command('current')
-  .description('Show the active profile')
+  .description('Show the active legacy profile and isolated launch metadata')
   .action(currentCommand);
 
 program
@@ -42,6 +54,11 @@ program
   .description('List all profiles')
   .action(listCommand);
 
+program
+  .command('status')
+  .description('Show CSP status dashboard')
+  .action(statusCommand);
+
 program
   .command('create <name>')
   .description('Create a new profile from current Claude Code state')
@@ -60,9 +77,13 @@ program
   .description('Switch to a different profile')
   .option('--dry-run', 'Show what would change without executing')
   .option('--no-save', 'Skip saving current profile before switching')
-  .option('--force', 'Switch even if symlink targets are missing')
   .action(useCommand);
 
+program
+  .command('toggle')
+  .description('Switch to the previous profile')
+  .action(toggleCommand);
+
 program
   .command('delete <name>')
   .alias('rm')
@@ -88,4 +109,32 @@ program
   .description('Compare two profiles (use "current" for active profile)')
   .action(diffCommand);
 
+program
+  .command('deactivate')
+  .description('Deactivate the current profile (remove managed items from ~/.claude)')
+  .option('--no-save', 'Skip saving current profile before deactivating')
+  .action(deactivateCommand);
+
+program
+  .command('launch <name> [args...]')
+  .alias('la')
+  .description('Launch isolated Claude session for a profile (use --legacy-global for old switch+launch behavior)')
+  .option('--legacy-global', 'Use legacy global switch path before launching Claude')
+  .allowUnknownOption(true)
+  .enablePositionalOptions(true)
+  .passThroughOptions(true)
+  .action((name, args, options, cmd) => {
+    // Merge explicit positional args with unknown options (e.g. --dangerously-skip-permissions)
+    const unknownOpts = cmd.args.filter((a) => a !== name && !args.includes(a));
+    const claudeArgs = [...args, ...unknownOpts];
+    launchCommand(name, claudeArgs, options);
+  });
+
+program
+  .command('uninstall')
+  .description('Remove all profiles and restore Claude Code to pre-CSP state')
+  .option('-f, --force', 'Skip confirmation prompt')
+  .option('--profile <name>', 'Restore specific profile instead of active one')
+  .action(uninstallCommand);
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-switch-profile",
-  "version": "1.0.2",
+  "version": "1.4.0",
   "description": "CLI tool for managing multiple Claude Code profiles",
   "type": "module",
   "bin": {