claude-switch-profile 1.4.0 → 1.4.2

package/.cocoindex_code/settings.yml

@@ -0,0 +1,41 @@
+exclude_patterns:
+- '**/.*'
+- '**/__pycache__'
+- '**/node_modules'
+- '**/target'
+- '**/build/assets'
+- '**/dist'
+- '**/vendor/*.*/*'
+- '**/vendor/*'
+- '**/.cocoindex_code'
+include_patterns:
+- '**/*.py'
+- '**/*.pyi'
+- '**/*.js'
+- '**/*.jsx'
+- '**/*.ts'
+- '**/*.tsx'
+- '**/*.mjs'
+- '**/*.cjs'
+- '**/*.rs'
+- '**/*.go'
+- '**/*.java'
+- '**/*.c'
+- '**/*.h'
+- '**/*.cpp'
+- '**/*.hpp'
+- '**/*.cc'
+- '**/*.cxx'
+- '**/*.hxx'
+- '**/*.hh'
+- '**/*.cs'
+- '**/*.sql'
+- '**/*.sh'
+- '**/*.bash'
+- '**/*.zsh'
+- '**/*.md'
+- '**/*.mdx'
+- '**/*.txt'
+- '**/*.rst'
+- '**/*.php'
+- '**/*.lua'

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to `claude-switch-profile` are documented here.
 
+## [Unreleased]
+
+### Changed
+- _No changes yet._
+
+---
+
+## [1.4.1] - 2026-03-31
+
+### Changed
+- `default` is now a physical profile snapshot created by `csp init` instead of a virtual pass-through.
+- `csp save`, `csp use`, `csp export`, `csp launch`, and `csp uninstall` now operate on the `default` snapshot the same way they do for other profiles.
+- Legacy installs missing `~/.claude-profiles/default` only backfill that snapshot when the active profile is `default` or no active profile is set; if a non-default profile is active, CSP fails closed with repair guidance.
+- Protected and session/runtime files remain excluded from snapshot capture, export, isolated runtime sync, and restore flows.
+- Launching `default` keeps its metadata mode as `legacy` instead of drifting to `account-session`.
+- README command reference refreshed to match current CLI behavior (`select` default command, `status`, `toggle`, `create --source`, import symlink safety validation, updated project structure, and GitHub repository link).
+
+---
+
 ## [1.3.0] - 2026-03-28
 
 ### Added

package/README.md

@@ -4,6 +4,8 @@
 [![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)
 
+**GitHub:** https://github.com/ThanhThi2895/claude-switch-profile
+
 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
@@ -53,13 +55,13 @@ csp --help
 
 ### 1. Initialize
 
-Capture your current Claude Code setup as the default profile:
+Capture your current Claude Code setup as the physical `default` profile snapshot:
 
 ```bash
 csp init
 ```
 
-This creates `~/.claude-profiles/default/` containing your current configuration.
+This creates `~/.claude-profiles/default/` from the current managed contents of `~/.claude`. Protected and session/runtime files remain excluded.
 
 ### 2. Create Additional Profiles
 
@@ -116,7 +118,15 @@ Output example:
 
 The `*` marks the active profile.
 
-### 6. Uninstall CSP
+### 6. Launch via Interactive Selector (Default Command)
+
+Run `csp` without a subcommand to open the interactive selector and launch a profile immediately:
+
+```bash
+csp
+```
+
+### 7. Uninstall CSP
 
 Remove CSP and restore your Claude Code to its original state:
 
@@ -127,6 +137,22 @@ csp uninstall
 
 ## Commands Reference
 
+### select (default)
+
+Open interactive profile selector (default behavior when you run `csp` without subcommand).
+
+```bash
+csp
+csp select
+```
+
+**Behavior:**
+- If TTY and multiple profiles exist: shows arrow-key menu and launches selected profile via `csp launch <name>`
+- If only one profile exists: shows informational message and exits
+- If non-interactive terminal: asks to use `csp launch <name>` or `csp use <name>` directly
+
+---
+
 ### init
 
 Initialize the profile system and capture current state as "default" profile.
@@ -182,6 +208,16 @@ The `*` marks the currently active profile.
 
 ---
 
+### status
+
+Show CSP status dashboard (active profile, profile count, last launch, Claude process state).
+
+```bash
+csp status
+```
+
+---
+
 ### create
 
 Create a new profile from current state or clone existing profile.
@@ -192,6 +228,7 @@ csp create <name> [options]
 
 **Options:**
 - `--from <profile>` — Clone from existing profile instead of current state
+- `-s, --source <path>` — Create from a specific kit directory, then inherit missing managed items from current `~/.claude`
 - `-d, --description <text>` — Add description to profile
 
 **Examples:**
@@ -211,10 +248,16 @@ Clone from existing:
 csp create backup --from production
 ```
 
+Create from kit directory:
+```bash
+csp create team-kit --source ~/my-kit/.agents -d "Team baseline"
+```
+
 **Behavior:**
 - Creates profile directory: `~/.claude-profiles/<name>/`
 - If `--from` is specified, clones all content from source profile
-- Otherwise, captures current `~/.claude` state
+- If `--source` is specified, copies managed items from that directory, then fills missing managed items from current `~/.claude`
+- Otherwise, performs full clone of current `~/.claude` excluding protected/session items
 - If this is the first profile, automatically sets it as active
 - Saves metadata (created timestamp, description)
 
@@ -229,10 +272,11 @@ csp save
 ```
 
 **Behavior:**
-- 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)
+- Captures all managed items and copied files/directories from `~/.claude`
+- Overwrites the active profile snapshot (`source.json` plus copied content)
+- When `default` is active, updates the physical `default` snapshot like any other profile
+- Protected and session/runtime files remain excluded
+- Requires an active profile
 
 ---
 
@@ -247,7 +291,6 @@ csp use <name> [options]
 **Options:**
 - `--dry-run` — Show what would change without executing
 - `--no-save` — Skip saving current profile before switching
-- `--force` — Accepted for compatibility (current switch path does not block on target-link validation)
 
 **Examples:**
 
@@ -266,19 +309,30 @@ Switch without saving current state:
 csp use backup --no-save
 ```
 
-Force switch with missing targets:
-```bash
-csp use legacy --force
-```
-
 **Behavior:**
 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. Removes managed items/files from `~/.claude` as needed
-5. Restores target profile configuration into `~/.claude`
+3. If the active profile exists and `--no-save` is not set: saves its current snapshot first
+4. Removes managed items/files from `~/.claude`
+5. Restores the target profile snapshot into `~/.claude` — including `default`
 6. Updates active marker
-7. **Important:** Claude Code session must be restarted for changes to apply
+7. On older installs missing `profiles/default`, CSP only backfills that snapshot when the active profile is `default` or no active profile is set; otherwise it fails closed with repair guidance
+8. **Important:** Claude Code session must be restarted for changes to apply
+
+---
+
+### toggle
+
+Launch the previous profile (does not mutate global active profile in isolated mode).
+
+```bash
+csp toggle
+```
+
+**Behavior:**
+- Reads previous profile marker from `~/.claude-profiles/.previous`
+- Validates previous profile still exists
+- Delegates to `csp launch <previous>`
 
 ---
 
@@ -308,10 +362,11 @@ csp delete old-setup --force
 ```
 
 **Behavior:**
-- Cannot delete the active profile (must switch first)
+- Cannot delete `default`
 - Prompts for confirmation unless `--force` is used
 - Permanently removes profile directory and metadata
-- Cannot be undone (but auto-backups from `use` are preserved)
+- If deleting the currently active non-default profile: clears active marker only (does not mutate `~/.claude`)
+- Cannot be undone
 
 ---
 
@@ -340,8 +395,10 @@ csp export staging -o ~/backups/claude-staging.tar.gz
 ```
 
 **Behavior:**
-- Creates tar.gz archive of entire profile directory
-- Includes `source.json` (managed item map) and copied profile files/directories
+- Creates tar.gz archive of the profile snapshot directory
+- Includes `source.json` plus copied profile files/directories
+- Exporting `default` works like any other profile snapshot
+- Protected and session/runtime files remain excluded from the archive
 - Useful for backup, sharing, or version control
 
 ---
@@ -374,6 +431,8 @@ csp import backup.tar.gz -n restored -d "Restored from backup"
 **Behavior:**
 - Extracts archive to `~/.claude-profiles/<name>/`
 - Uses filename as profile name if `--name` not specified
+- Validates imported profile structure
+- Rejects import if managed/copied items contain symlink targets outside profile directory (safety check)
 - Creates metadata entry for profile
 - Profile is ready to use immediately
 
@@ -422,7 +481,7 @@ File differences:
 
 ### deactivate
 
-Deactivate the currently active non-default profile and clear `.active` without switching to another profile.
+Deactivate the currently active non-default profile by switching back to the physical `default` snapshot.
 
 ```bash
 csp deactivate
@@ -433,9 +492,10 @@ csp deactivate
 
 **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
+2. Delegates to `csp use default`
+3. Optionally saves the current non-default profile state
+4. Restores the physical `default` snapshot into `~/.claude`
+5. Marks `default` as the active legacy profile
 
 ---
 
@@ -471,20 +531,22 @@ 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`
+2. Ensures the profile snapshot exists; for legacy installs missing `default/`, guarded backfill only runs when the active profile is `default` or no active profile is set
+3. Prepares per-profile runtime under `~/.claude-profiles/.runtime/<name>`
+4. 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
+5. Strips inherited `CLAUDECODE`, inherited `CLAUDE_CONFIG_DIR`, inherited `ANTHROPIC_*`, and Claude session env vars before applying resolved allowlisted values
+6. Spawns `claude` with `CLAUDE_CONFIG_DIR=<runtimeDir>`
+7. Inherits stdin/stdout/stderr for interactive use
+8. Forwards Claude's exit code
+9. Keeps `.active` unchanged and never mutates global `~/.claude`
+10. Launching `default` preserves its `legacy` mode metadata even though it uses an isolated runtime snapshot
 
 `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).
+Set `CSP_DEBUG_LAUNCH_ENV=1` to print extended launch diagnostics. Do not use in shared logs because it can include resolved `ANTHROPIC_*` values.
 
 ---
 
@@ -520,9 +582,10 @@ 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`
+2. Restores the active profile by default, or the `--profile` choice, to `~/.claude`
+3. If `default` is restored, it uses the physical `default` snapshot like any other profile
+4. Removes `~/.claude-profiles/` entirely
+5. Prints reminder to run `npm uninstall -g claude-switch-profile`
 
 ---
 
@@ -561,7 +624,7 @@ Profiles are stored in `~/.claude-profiles/`:
 - `agents/` — Agent scripts and configurations
 - `skills/` — Custom Luna skills
 - `hooks/` — Pre/post action hooks
-- `statusline.cjs` — Custom statusline
+- `statusline.cjs`, `statusline.sh`, `statusline.ps1` — Custom statusline scripts
 - `.luna.json` — Luna configuration
 
 **Copied Files**:
@@ -583,7 +646,7 @@ Profiles are stored in `~/.claude-profiles/`:
 - `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
+- All other protected or session-specific data
 
 ### Legacy vs Isolated Launch Modes
 
@@ -664,11 +727,7 @@ Before switching, CSP validates:
 1. Target profile exists
 2. Profile structure is valid
 
-`--force` is currently accepted for compatibility:
-
-```bash
-csp use legacy --force
-```
+During import, CSP also validates profile contents and rejects unsafe symlinks that point outside the imported profile tree.
 
 ## Configuration via Environment Variables
 
@@ -727,7 +786,7 @@ csp use personal  # Switch to personal
 
 ```bash
 # Clone current profile
-csp create experimental --from current -d "Testing new Luna skills"
+csp create experimental --from default -d "Testing new Luna skills"
 
 # Switch and experiment
 csp use experimental
@@ -791,15 +850,14 @@ csp list
 csp use production  # if "production" exists
 ```
 
-### Cannot delete active profile
+### Cannot delete default profile
 
-**Error:** `Cannot delete active profile "default". Switch to another profile first.`
+**Error:** `Cannot delete the default profile.`
 
-**Solution:** Switch to a different profile before deleting.
+**Solution:** Keep `default` and delete only non-default profiles.
 
 ```bash
-csp use production
-csp delete default
+csp delete experimental
 ```
 
 ### Stale lock file
@@ -855,13 +913,16 @@ See [CHANGELOG.md](CHANGELOG.md) for version history and migration guidance.
 │   │   ├── init.js
 │   │   ├── current.js
 │   │   ├── list.js
+│   │   ├── status.js
 │   │   ├── create.js
 │   │   ├── save.js
 │   │   ├── use.js
+│   │   ├── toggle.js
 │   │   ├── delete.js
 │   │   ├── export.js
 │   │   ├── import.js
 │   │   ├── diff.js
+│   │   ├── select.js
 │   │   ├── launch.js
 │   │   ├── deactivate.js
 │   │   └── uninstall.js
@@ -871,6 +932,7 @@ See [CHANGELOG.md](CHANGELOG.md) for version history and migration guidance.
 │   ├── runtime-instance-manager.js # Isolated runtime sync
 │   ├── item-manager.js           # Managed item copy/move operations
 │   ├── file-operations.js        # File copy/restore operations
+│   ├── launch-effective-env-resolver.js # ANTHROPIC_* launch env resolution
 │   ├── safety.js                 # Locking, backups, validation
 │   ├── profile-validator.js      # Profile validation
 │   └── output-helpers.js         # Console output formatting

package/package.json

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

package/src/commands/create.js

@@ -1,4 +1,4 @@
-import { mkdirSync, cpSync, existsSync, statSync, writeFileSync, copyFileSync, readdirSync, lstatSync } from 'node:fs';
+import { mkdirSync, cpSync, existsSync, writeFileSync, readdirSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { addProfile, getActive, setActive, profileExists, getProfileDir } from '../profile-store.js';
 import { saveFiles, updateSettingsPaths } from '../file-operations.js';
@@ -20,7 +20,7 @@ export const createCommand = (name, options) => {
       process.exit(1);
     }
     const sourceDir = getProfileDir(options.from);
-    cpSync(sourceDir, profileDir, { recursive: true });
+    cpSync(sourceDir, profileDir, { recursive: true, verbatimSymlinks: true });
     info(`Cloned from profile "${options.from}"`);
   } else if (options.source) {
     // Create from a specific .agents/ directory (or any kit directory)
@@ -39,11 +39,7 @@ export const createCommand = (name, options) => {
       if (existsSync(target)) {
         const dest = join(profileDir, item);
         try {
-          if (statSync(target).isDirectory()) {
-            cpSync(target, dest, { recursive: true });
-          } else {
-            copyFileSync(target, dest);
-          }
+          cpSync(target, dest, { recursive: true, verbatimSymlinks: true });
           sourceMap[item] = dest;
         } catch { /* skip */ }
       }
@@ -60,11 +56,7 @@ export const createCommand = (name, options) => {
       if (!existsSync(src)) continue;
       try {
         const dest = join(profileDir, item);
-        if (statSync(src).isDirectory()) {
-          cpSync(src, dest, { recursive: true });
-        } else {
-          copyFileSync(src, dest);
-        }
+        cpSync(src, dest, { recursive: true, verbatimSymlinks: true });
         sourceMap[item] = dest;
       } catch { /* skip */ }
     }
@@ -92,20 +84,11 @@ export const createCommand = (name, options) => {
 
       const src = join(CLAUDE_DIR, entry);
       try {
-        const stat = lstatSync(src);
-
-        if (stat.isDirectory()) {
-          const dest = join(profileDir, entry);
-          cpSync(src, dest, { recursive: true });
-          if (MANAGED_ITEMS.includes(entry)) {
-            sourceMap[entry] = dest;
-          }
-        } else if (stat.isFile()) {
-          const dest = join(profileDir, entry);
-          copyFileSync(src, dest);
-          if (MANAGED_ITEMS.includes(entry)) {
-            sourceMap[entry] = dest;
-          }
+        const dest = join(profileDir, entry);
+        cpSync(src, dest, { recursive: true, verbatimSymlinks: true });
+
+        if (MANAGED_ITEMS.includes(entry)) {
+          sourceMap[entry] = dest;
         }
       } catch { /* skip unreadable items */ }
     }

package/src/commands/current.js

@@ -1,5 +1,6 @@
-import { getActive, getProfileDir, getProfileMeta } from '../profile-store.js';
-import { success, info, warn } from '../output-helpers.js';
+import { getActive, getProfileDir, getProfileMeta, ensureDefaultProfileSnapshot } from '../profile-store.js';
+import { DEFAULT_PROFILE } from '../constants.js';
+import { success, info, warn, error } from '../output-helpers.js';
 
 export const currentCommand = () => {
   const active = getActive();
@@ -7,6 +8,16 @@ export const currentCommand = () => {
     warn('No active profile. Run "csp create <name>" to create one.');
     return;
   }
+
+  if (active === DEFAULT_PROFILE) {
+    try {
+      ensureDefaultProfileSnapshot();
+    } catch (err) {
+      error(err.message);
+      process.exit(1);
+    }
+  }
+
   success(`Active legacy profile: ${active}`);
   info(`Location: ${getProfileDir(active)}`);
 

package/src/commands/deactivate.js

@@ -1,8 +1,9 @@
-import { getActive, setActive } from '../profile-store.js';
+import { getActive } from '../profile-store.js';
 import { success, info } from '../output-helpers.js';
 import { DEFAULT_PROFILE } from '../constants.js';
+import { useCommand } from './use.js';
 
-export const deactivateCommand = async () => {
+export const deactivateCommand = async (options = {}) => {
   const active = getActive();
   if (!active) {
     info('No active profile to deactivate.');
@@ -10,13 +11,10 @@ export const deactivateCommand = async () => {
   }
 
   if (active === DEFAULT_PROFILE) {
-    info('Default profile uses ~/.claude directly. Nothing to deactivate.');
+    info('Default profile is already active.');
     return;
   }
 
-  // Just reset to default — never touch ~/.claude
-  setActive(DEFAULT_PROFILE);
-
-  success(`Profile "${active}" deactivated. Reset to default.`);
-  info('~/.claude was not modified.');
+  await useCommand(DEFAULT_PROFILE, options);
+  success(`Profile "${active}" deactivated.`);
 };

package/src/commands/diff.js

@@ -1,7 +1,7 @@
 import { readFileSync, existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import chalk from 'chalk';
-import { profileExists, getActive, getEffectiveDir } from '../profile-store.js';
+import { profileExists, getActive, getEffectiveDir, getProfileDir } from '../profile-store.js';
 import { SOURCE_FILE, ALL_MANAGED } from '../constants.js';
 import { error, info } from '../output-helpers.js';
 
@@ -33,12 +33,14 @@ export const diffCommand = (profileA, profileB) => {
 
   const dirA = getEffectiveDir(nameA);
   const dirB = getEffectiveDir(nameB);
+  const sourceDirA = join(getProfileDir(nameA), SOURCE_FILE);
+  const sourceDirB = join(getProfileDir(nameB), SOURCE_FILE);
 
   console.log(`\n${chalk.bold('Comparing:')} ${chalk.cyan(nameA)} ↔ ${chalk.cyan(nameB)}\n`);
 
-  // Compare source.json (managed item sources)
-  const sourceA = readJsonSafe(join(dirA, SOURCE_FILE));
-  const sourceB = readJsonSafe(join(dirB, SOURCE_FILE));
+  // Compare source.json from stored profile dirs, not live ~/.claude state
+  const sourceA = readJsonSafe(sourceDirA);
+  const sourceB = readJsonSafe(sourceDirB);
   diffObject('Managed item sources (source.json)', sourceA, sourceB, nameA, nameB);
 
   // Compare files that exist in either profile

package/src/commands/export.js

@@ -1,6 +1,6 @@
 import { execFileSync } from 'node:child_process';
 import { resolve } from 'node:path';
-import { profileExists, getProfileDir, getActive } from '../profile-store.js';
+import { profileExists, getProfileDir, getActive, ensureDefaultProfileSnapshot } from '../profile-store.js';
 import { isWindows } from '../platform.js';
 import { saveItems } from '../item-manager.js';
 import { saveFiles, updateSettingsPaths } from '../file-operations.js';
@@ -9,8 +9,12 @@ import { DEFAULT_PROFILE } from '../constants.js';
 
 export const exportCommand = (name, options) => {
   if (name === DEFAULT_PROFILE) {
-    error('Cannot export the default profile (it uses ~/.claude directly).');
-    process.exit(1);
+    try {
+      ensureDefaultProfileSnapshot();
+    } catch (err) {
+      error(err.message);
+      process.exit(1);
+    }
   }
 
   if (!profileExists(name)) {
@@ -22,7 +26,6 @@ export const exportCommand = (name, options) => {
   const output = options.output || `./${name}.csp.tar.gz`;
   const outputPath = resolve(output);
 
-  // If exporting active profile, save a copy first (non-destructive)
   const active = getActive();
   if (active === name) {
     saveItems(profileDir);