@aravhawk/cc-switch 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arav Jain
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,170 @@
+# cc-switch
+
+Profile manager for Claude Code settings. Easily manage and switch between multiple Claude Code configurations.
+
+## Installation
+
+```bash
+npm install -g @aravhawk/cc-switch
+```
+
+Or with pnpm:
+
+```bash
+pnpm add -g @aravhawk/cc-switch
+```
+
+## Usage
+
+### Interactive Mode
+
+Run `cc-switch` without arguments to enter interactive mode:
+
+```bash
+cc-switch
+```
+
+This will present a menu with options to:
+- Switch between profiles
+- Create new profiles
+- Delete profiles
+- Rename profiles
+- List all profiles
+
+### Command Line Mode
+
+#### Switch Profile
+
+```bash
+cc-switch switch <profile-name>
+```
+
+Example:
+```bash
+cc-switch switch work
+```
+
+#### Create Profile
+
+Create a new profile from your current `~/.claude/settings.json`:
+
+```bash
+cc-switch create <profile-name>
+```
+
+Example:
+```bash
+cc-switch create personal
+```
+
+#### Delete Profile
+
+Delete an existing profile (cannot delete the active profile):
+
+```bash
+cc-switch delete <profile-name>
+```
+
+Example:
+```bash
+cc-switch delete old-config
+```
+
+#### Rename Profile
+
+Rename an existing profile:
+
+```bash
+cc-switch rename <old-name> <new-name>
+```
+
+Example:
+```bash
+cc-switch rename work work-2024
+```
+
+#### List Profiles
+
+List all available profiles:
+
+```bash
+cc-switch list
+```
+
+## How It Works
+
+`cc-switch` manages multiple Claude Code profiles by storing copies of your `settings.json` file in separate profile directories.
+
+### Data Layout
+
+```
+~/.cc-switch/
+├── profiles/
+│   ├── default/
+│   │   └── settings.json
+│   ├── work/
+│   │   └── settings.json
+│   └── personal/
+│       └── settings.json
+└── state.json
+```
+
+### State File
+
+The `state.json` file tracks the currently active profile:
+
+```json
+{
+  "activeProfile": "default",
+  "lastSyncedAt": "2026-02-01T12:34:56.789Z"
+}
+```
+
+### Switch Behavior
+
+When you switch profiles:
+
+1. The current `~/.claude/settings.json` is mirrored back to the active profile's directory
+2. The target profile's `settings.json` is copied to `~/.claude/settings.json`
+3. The active profile is updated in `state.json`
+
+This ensures you never lose your current settings when switching.
+
+## Requirements
+
+- Node.js 18 or higher
+- Claude Code installed (with `~/.claude/settings.json` present)
+
+## First-Time Setup
+
+If you don't have a `~/.claude/settings.json` file, you'll see this error:
+
+```
+No ~/.claude/settings.json found. Run Claude Code once to generate it,
+or run the setup script provided by your provider (e.g., Z.ai).
+```
+
+Simply run Claude Code once to generate the initial settings file, then you can start using `cc-switch`.
+
+## Profile Name Rules
+
+Profile names must:
+- Not be empty
+- Only contain letters, numbers, hyphens, and underscores
+- Not contain path separators (`/`, `\`, `..`)
+
+## Error Handling
+
+`cc-switch` provides clear error messages for common issues:
+
+- Missing Claude settings file
+- Profile not found
+- Attempting to delete the active profile
+- Invalid profile names
+- Permission errors
+
+All operations use atomic file writes to prevent data loss.
+
+## License
+
+[MIT](LICENSE)

package/dist/index.js

@@ -0,0 +1,399 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import * as clack from "@clack/prompts";
+
+// src/profiles.ts
+import { readFile as readFile2, writeFile as writeFile2, mkdir as mkdir2, rm, readdir, rename as fsRename, access } from "fs/promises";
+import { dirname as dirname2 } from "path";
+
+// src/paths.ts
+import { homedir } from "os";
+import { join } from "path";
+var CLAUDE_DIR = join(homedir(), ".claude");
+var CLAUDE_SETTINGS = join(CLAUDE_DIR, "settings.json");
+var CC_SWITCH_DIR = join(homedir(), ".cc-switch");
+var PROFILES_DIR = join(CC_SWITCH_DIR, "profiles");
+var STATE_FILE = join(CC_SWITCH_DIR, "state.json");
+function getProfileDir(profileName) {
+  return join(PROFILES_DIR, profileName);
+}
+function getProfileSettings(profileName) {
+  return join(getProfileDir(profileName), "settings.json");
+}
+
+// src/state.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { dirname } from "path";
+var DEFAULT_STATE = {
+  activeProfile: "default",
+  lastSyncedAt: (/* @__PURE__ */ new Date()).toISOString()
+};
+async function readState() {
+  try {
+    const data = await readFile(STATE_FILE, "utf-8");
+    return JSON.parse(data);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return DEFAULT_STATE;
+    }
+    throw error;
+  }
+}
+async function writeState(state) {
+  await mkdir(dirname(STATE_FILE), { recursive: true });
+  const tempFile = `${STATE_FILE}.tmp`;
+  await writeFile(tempFile, JSON.stringify(state, null, 2), "utf-8");
+  await writeFile(STATE_FILE, JSON.stringify(state, null, 2), "utf-8");
+}
+async function updateState(updates) {
+  const currentState = await readState();
+  const newState = {
+    ...currentState,
+    ...updates,
+    lastSyncedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  await writeState(newState);
+  return newState;
+}
+
+// src/validation.ts
+function validateProfileName(name) {
+  if (!name || name.trim().length === 0) {
+    return { valid: false, error: "Profile name cannot be empty" };
+  }
+  if (name.includes("..") || name.includes("/") || name.includes("\\")) {
+    return { valid: false, error: 'Profile name cannot contain "..", "/", or "\\"' };
+  }
+  if (!/^[A-Za-z0-9-_]+$/.test(name)) {
+    return { valid: false, error: "Profile name can only contain letters, numbers, hyphens, and underscores" };
+  }
+  return { valid: true };
+}
+
+// src/profiles.ts
+async function checkClaudeSettings() {
+  try {
+    await access(CLAUDE_SETTINGS);
+  } catch {
+    throw new Error(
+      "No ~/.claude/settings.json found. Run Claude Code once to generate it, or run the setup script provided by your provider (e.g., Z.ai)."
+    );
+  }
+}
+async function listProfiles() {
+  const state = await readState();
+  try {
+    await mkdir2(PROFILES_DIR, { recursive: true });
+    const entries = await readdir(PROFILES_DIR, { withFileTypes: true });
+    const profiles = entries.filter((entry) => entry.isDirectory()).map((entry) => ({
+      name: entry.name,
+      isActive: entry.name === state.activeProfile
+    }));
+    return profiles.sort((a, b) => {
+      if (a.isActive) return -1;
+      if (b.isActive) return 1;
+      return a.name.localeCompare(b.name);
+    });
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return [];
+    }
+    throw error;
+  }
+}
+async function profileExists(profileName) {
+  try {
+    await access(getProfileDir(profileName));
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function mirrorSettings(profileName) {
+  const profileSettings = getProfileSettings(profileName);
+  await mkdir2(dirname2(profileSettings), { recursive: true });
+  const currentSettings = await readFile2(CLAUDE_SETTINGS, "utf-8");
+  const tempFile = `${profileSettings}.tmp`;
+  await writeFile2(tempFile, currentSettings, "utf-8");
+  await fsRename(tempFile, profileSettings);
+}
+async function switchProfile(targetProfile) {
+  const validation = validateProfileName(targetProfile);
+  if (!validation.valid) {
+    throw new Error(validation.error);
+  }
+  await checkClaudeSettings();
+  if (!await profileExists(targetProfile)) {
+    throw new Error(`Profile "${targetProfile}" does not exist`);
+  }
+  const state = await readState();
+  const activeProfile = state.activeProfile;
+  await mirrorSettings(activeProfile);
+  if (targetProfile === activeProfile) {
+    throw new Error(`Profile "${targetProfile}" is already active`);
+  }
+  const targetSettings = getProfileSettings(targetProfile);
+  const newSettings = await readFile2(targetSettings, "utf-8");
+  const tempFile = `${CLAUDE_SETTINGS}.tmp`;
+  await writeFile2(tempFile, newSettings, "utf-8");
+  await fsRename(tempFile, CLAUDE_SETTINGS);
+  await updateState({ activeProfile: targetProfile });
+}
+async function createProfile(profileName) {
+  const validation = validateProfileName(profileName);
+  if (!validation.valid) {
+    throw new Error(validation.error);
+  }
+  await checkClaudeSettings();
+  if (await profileExists(profileName)) {
+    throw new Error(`Profile "${profileName}" already exists`);
+  }
+  const profileSettings = getProfileSettings(profileName);
+  await mkdir2(dirname2(profileSettings), { recursive: true });
+  const currentSettings = await readFile2(CLAUDE_SETTINGS, "utf-8");
+  const tempFile = `${profileSettings}.tmp`;
+  await writeFile2(tempFile, currentSettings, "utf-8");
+  await fsRename(tempFile, profileSettings);
+}
+async function deleteProfile(profileName) {
+  const validation = validateProfileName(profileName);
+  if (!validation.valid) {
+    throw new Error(validation.error);
+  }
+  if (!await profileExists(profileName)) {
+    throw new Error(`Profile "${profileName}" does not exist`);
+  }
+  const state = await readState();
+  if (profileName === state.activeProfile) {
+    throw new Error(`Cannot delete active profile "${profileName}". Switch to another profile first.`);
+  }
+  await rm(getProfileDir(profileName), { recursive: true, force: true });
+}
+async function renameProfile(oldName, newName) {
+  const oldValidation = validateProfileName(oldName);
+  if (!oldValidation.valid) {
+    throw new Error(`Invalid old profile name: ${oldValidation.error}`);
+  }
+  const newValidation = validateProfileName(newName);
+  if (!newValidation.valid) {
+    throw new Error(`Invalid new profile name: ${newValidation.error}`);
+  }
+  if (!await profileExists(oldName)) {
+    throw new Error(`Profile "${oldName}" does not exist`);
+  }
+  if (await profileExists(newName)) {
+    throw new Error(`Profile "${newName}" already exists`);
+  }
+  await fsRename(getProfileDir(oldName), getProfileDir(newName));
+  const state = await readState();
+  if (oldName === state.activeProfile) {
+    await updateState({ activeProfile: newName });
+  }
+}
+
+// src/index.ts
+var program = new Command();
+program.name("cc-switch").description("Profile manager for Claude Code settings").version("1.0.0");
+program.command("switch <name>").description("Switch to a different profile").action(async (name) => {
+  try {
+    await switchProfile(name);
+    console.log(`Switched to profile "${name}"`);
+    process.exit(0);
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+});
+program.command("create <name>").description("Create a new profile from current settings").action(async (name) => {
+  try {
+    await createProfile(name);
+    console.log(`Created profile "${name}"`);
+    process.exit(0);
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+});
+program.command("delete <name>").description("Delete a profile").action(async (name) => {
+  try {
+    await deleteProfile(name);
+    console.log(`Deleted profile "${name}"`);
+    process.exit(0);
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+});
+program.command("rename <oldName> <newName>").description("Rename a profile").action(async (oldName, newName) => {
+  try {
+    await renameProfile(oldName, newName);
+    console.log(`Renamed profile "${oldName}" to "${newName}"`);
+    process.exit(0);
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+});
+program.command("list").description("List all profiles").action(async () => {
+  try {
+    const profiles = await listProfiles();
+    if (profiles.length === 0) {
+      console.log("No profiles found");
+      process.exit(0);
+    }
+    console.log("\nProfiles:");
+    for (const profile of profiles) {
+      const marker = profile.isActive ? " (active)" : "";
+      console.log(`  ${profile.name}${marker}`);
+    }
+    console.log();
+    process.exit(0);
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+});
+async function interactiveMode() {
+  clack.intro("cc-switch - Claude Code Profile Manager");
+  try {
+    const profiles = await listProfiles();
+    if (profiles.length === 0) {
+      clack.outro("No profiles found. Create one with: cc-switch create <name>");
+      process.exit(0);
+    }
+    const action = await clack.select({
+      message: "What would you like to do?",
+      options: [
+        { value: "switch", label: "Switch profile" },
+        { value: "create", label: "Create new profile" },
+        { value: "delete", label: "Delete profile" },
+        { value: "rename", label: "Rename profile" },
+        { value: "list", label: "List profiles" }
+      ]
+    });
+    if (clack.isCancel(action)) {
+      clack.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    switch (action) {
+      case "switch": {
+        const profileChoices = profiles.map((p) => ({
+          value: p.name,
+          label: p.isActive ? `${p.name} (active)` : p.name
+        }));
+        const selectedProfile = await clack.select({
+          message: "Select profile to switch to:",
+          options: profileChoices
+        });
+        if (clack.isCancel(selectedProfile)) {
+          clack.cancel("Operation cancelled");
+          process.exit(0);
+        }
+        await switchProfile(selectedProfile);
+        clack.outro(`Switched to profile "${selectedProfile}"`);
+        break;
+      }
+      case "create": {
+        const profileName = await clack.text({
+          message: "Enter new profile name:",
+          validate: (value) => {
+            if (!value) return "Profile name is required";
+            if (!/^[A-Za-z0-9-_]+$/.test(value)) {
+              return "Profile name can only contain letters, numbers, hyphens, and underscores";
+            }
+          }
+        });
+        if (clack.isCancel(profileName)) {
+          clack.cancel("Operation cancelled");
+          process.exit(0);
+        }
+        await createProfile(profileName);
+        clack.outro(`Created profile "${profileName}"`);
+        break;
+      }
+      case "delete": {
+        const nonActiveProfiles = profiles.filter((p) => !p.isActive);
+        if (nonActiveProfiles.length === 0) {
+          clack.outro("No profiles available to delete. Cannot delete the active profile.");
+          process.exit(0);
+        }
+        const profileChoices = nonActiveProfiles.map((p) => ({
+          value: p.name,
+          label: p.name
+        }));
+        const selectedProfile = await clack.select({
+          message: "Select profile to delete:",
+          options: profileChoices
+        });
+        if (clack.isCancel(selectedProfile)) {
+          clack.cancel("Operation cancelled");
+          process.exit(0);
+        }
+        const confirmDelete = await clack.confirm({
+          message: `Are you sure you want to delete profile "${selectedProfile}"?`
+        });
+        if (clack.isCancel(confirmDelete)) {
+          clack.cancel("Operation cancelled");
+          process.exit(0);
+        }
+        if (!confirmDelete) {
+          clack.outro("Deletion cancelled");
+          process.exit(0);
+        }
+        await deleteProfile(selectedProfile);
+        clack.outro(`Deleted profile "${selectedProfile}"`);
+        break;
+      }
+      case "rename": {
+        const profileChoices = profiles.map((p) => ({
+          value: p.name,
+          label: p.isActive ? `${p.name} (active)` : p.name
+        }));
+        const oldName = await clack.select({
+          message: "Select profile to rename:",
+          options: profileChoices
+        });
+        if (clack.isCancel(oldName)) {
+          clack.cancel("Operation cancelled");
+          process.exit(0);
+        }
+        const newName = await clack.text({
+          message: "Enter new profile name:",
+          validate: (value) => {
+            if (!value) return "Profile name is required";
+            if (!/^[A-Za-z0-9-_]+$/.test(value)) {
+              return "Profile name can only contain letters, numbers, hyphens, and underscores";
+            }
+          }
+        });
+        if (clack.isCancel(newName)) {
+          clack.cancel("Operation cancelled");
+          process.exit(0);
+        }
+        await renameProfile(oldName, newName);
+        clack.outro(`Renamed profile "${oldName}" to "${newName}"`);
+        break;
+      }
+      case "list": {
+        console.log("\nProfiles:");
+        for (const profile of profiles) {
+          const marker = profile.isActive ? " (active)" : "";
+          console.log(`  ${profile.name}${marker}`);
+        }
+        console.log();
+        clack.outro("Profile list complete");
+        break;
+      }
+    }
+    process.exit(0);
+  } catch (error) {
+    clack.outro(`Error: ${error.message}`);
+    process.exit(1);
+  }
+}
+program.parse();
+if (!process.argv.slice(2).length) {
+  interactiveMode();
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@aravhawk/cc-switch",
+  "version": "1.0.1",
+  "description": "Profile manager for Claude Code settings",
+  "type": "module",
+  "bin": {
+    "cc-switch": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "cli",
+    "profile-manager",
+    "settings"
+  ],
+  "author": "Arav",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.10",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}