@remeic/ccm 0.1.0 → 0.3.0

package/README.md

@@ -1,23 +1,45 @@
-# ccm
-
-> Multi-profile manager for Claude Code
-
-[![CI](https://github.com/remeic/ccm-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/remeic/ccm-cli/actions/workflows/ci.yml)
+<div id="toc">
+  <table>
+    <tr>
+      <td width="170" valign="top">
+        <img src="./docs/assets/ccm-logo.png" alt="CCM Logo" width="150" height="150" />
+      </td>
+      <td valign="middle">
+        <h1 align="left">ccm</h1>
+        <p><strong>Multi-profile manager for Claude Code</strong></p>
+        <p>Switch between Claude Code accounts instantly. Like <code>nvm</code> for Claude Code profiles.</p>
+      </td>
+    </tr>
+  </table>
+</div>
+
+[![CI](https://github.com/remeic/ccm/actions/workflows/ci.yml/badge.svg)](https://github.com/remeic/ccm/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/%40remeic%2Fccm.svg)](https://www.npmjs.com/package/@remeic/ccm)
+[![Homebrew tap](https://img.shields.io/badge/Homebrew-tap-FBB040?logo=homebrew&logoColor=white)](https://github.com/Remeic/homebrew-tap)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
-[![codecov](https://codecov.io/github/Remeic/ccm-cli/graph/badge.svg?token=E16LCLDHYV)](https://codecov.io/github/Remeic/ccm-cli)
+[![codecov](https://codecov.io/github/Remeic/ccm/graph/badge.svg?token=E16LCLDHYV)](https://codecov.io/github/Remeic/ccm)
 [![mutation testing](https://img.shields.io/badge/mutation%20testing-100%25-brightgreen)](https://stryker-mutator.io/)
 
-Switch between Claude Code accounts instantly. Like `nvm` for Claude Code profiles.
+Manage separate Claude Code profiles for personal, work, and client accounts without repeated logout/login cycles. `ccm` keeps each profile isolated so switching is immediate and parallel sessions stay clean.
+
+<p align="center">
+  <img src="./docs/assets/intro.gif" alt="ccm in action in a terminal view" width="100%" />
+</p>
 
 ## Table of Contents
 
+- [Table of Contents](#table-of-contents)
 - [Why](#why)
 - [Prerequisites](#prerequisites)
 - [Install](#install)
 - [Quick Start](#quick-start)
 - [Commands](#commands)
+- [Passing Flags and Environment Variables](#passing-flags-and-environment-variables)
+- [Multi-Account Login](#multi-account-login)
+  - [Different Browser per Profile](#different-browser-per-profile)
+  - [URL-Only Mode](#url-only-mode)
+  - [API Key Auth](#api-key-auth)
 - [How It Works](#how-it-works)
   - [Architecture Overview](#architecture-overview)
   - [Profile Isolation](#profile-isolation)
@@ -46,13 +68,20 @@ Claude Code stores authentication in a single config directory. If you use multi
 ## Install
 
 ```sh
-npm i -g @remeic/ccm
+npm install -g @remeic/ccm
+pnpm add -g @remeic/ccm
+yarn global add @remeic/ccm
+bun add -g @remeic/ccm
+brew install remeic/tap/ccm
 ```
 
-Or run without installing:
+Homebrew core already ships an unrelated `ccm` formula, so install this one with the fully qualified tap name.
 
 ```sh
 npx @remeic/ccm <command>
+pnpm dlx @remeic/ccm <command>
+yarn dlx @remeic/ccm <command>
+bunx @remeic/ccm <command>
 ```
 
 The installed command remains `ccm`.
@@ -73,15 +102,16 @@ $ ccm use work
 
 ## Commands
 
-| Command | Description |
-|---|---|
-| `ccm create <name> [-l label] [-b browser]` | Create a profile. `-b` sets the browser for OAuth |
-| `ccm list` | List all profiles with auth status, including drifted entries |
-| `ccm use <name> [-- args]` | Launch Claude Code. Args after `--` are passed to Claude |
-| `ccm login <name> [--console] [-b browser] [--url-only]` | Authenticate a profile |
-| `ccm status [name]` | Show auth status and storage state for one or all profiles |
-| `ccm remove <name> [-f]` | Remove a profile. `-f` skips confirmation |
-| `ccm run <name> -p <prompt>` | Run a prompt non-interactively |
+| Command                                                  | Description                                                   |
+| -------------------------------------------------------- | ------------------------------------------------------------- |
+| `ccm create <name> [-l label] [-b browser]`              | Create a profile. `-b` sets the browser for OAuth             |
+| `ccm list`                                               | List all profiles with auth status, including drifted entries |
+| `ccm use <name> [-- args]`                               | Launch Claude Code. Args after `--` are passed to Claude      |
+| `ccm login <name> [--console] [-b browser] [--url-only]` | Authenticate a profile                                        |
+| `ccm status [name]`                                      | Show auth status and storage state for one or all profiles    |
+| `ccm rename <old-name> <new-name>`                       | Rename a profile (config, directory, and browser wrapper)      |
+| `ccm remove <name> [-f]`                                 | Remove a profile. `-f` skips confirmation                     |
+| `ccm run <name> -p <prompt>`                             | Run a prompt non-interactively                                |
 
 ## Passing Flags and Environment Variables
 
@@ -176,6 +206,7 @@ src/
     ├── login.ts             # Authenticate via Claude TUI or --console
     ├── use.ts               # Launch Claude with profile config dir
     ├── status.ts            # Show auth status and drift state
+    ├── rename.ts            # Rename profile with atomic rollback
     ├── remove.ts            # Remove profile with staged rollback
     └── run.ts               # Run prompt with specific profile
 ```
@@ -331,8 +362,8 @@ ccm locates the Claude binary using the following strategy:
 
 ## Configuration
 
-| Variable | Description |
-|---|---|
+| Variable     | Description                                                                                      |
+| ------------ | ------------------------------------------------------------------------------------------------ |
 | `CLAUDE_BIN` | Override the path to the Claude binary. Useful if Claude is installed in a non-standard location |
 
 All ccm data is stored in `~/.ccm/`. This includes the config file and all profile directories.
@@ -351,12 +382,12 @@ You can verify this yourself: the runtime dependencies are [Commander.js](https:
 
 ## Comparison
 
-| | Without ccm | With ccm |
-|---|---|---|
-| Switch accounts | `claude auth logout` then `claude auth login` | `ccm use work` |
-| Multiple sessions | Not possible simultaneously | Each profile runs independently |
-| Config mixing risk | High — single config directory | None — full isolation |
-| Setup per account | Manual every time | One-time `create` + `login` |
+|                    | Without ccm                                   | With ccm                        |
+| ------------------ | --------------------------------------------- | ------------------------------- |
+| Switch accounts    | `claude auth logout` then `claude auth login` | `ccm use work`                  |
+| Multiple sessions  | Not possible simultaneously                   | Each profile runs independently |
+| Config mixing risk | High — single config directory                | None — full isolation           |
+| Setup per account  | Manual every time                             | One-time `create` + `login`     |
 
 ## FAQ
 
@@ -378,6 +409,23 @@ ccm uses cross-platform binary discovery (`which`/`where`) and standard Node.js
 
 ## Contributing
 
+### Homebrew Releases
+
+Homebrew publication is handled through a dedicated tap, not `homebrew/core`. After `npm publish`, the release workflow updates `Formula/ccm.rb` in the tap repository.
+
+To keep the release PR and changelog accurate, prefer **Squash and merge** with a Conventional Commit PR title like `feat: add profile import command`. `release-please` uses the merged commit on `main`, so `docs:` and `refactor:` changes are typically omitted from Node release notes while `feat:` and `fix:` become releasable entries.
+
+Required repository configuration:
+
+- `HOMEBREW_TAP_GITHUB_TOKEN`: GitHub token with write access to the tap repo
+- `HOMEBREW_TAP_REPOSITORY`: optional repository override, defaults to `remeic/homebrew-tap`
+
+Generate the formula locally:
+
+```sh
+bun run homebrew:formula -- --sha256 <npm-tarball-sha256> --output /tmp/ccm.rb
+```
+
 See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## License

package/dist/index.js

@@ -48,6 +48,14 @@ function getStagedPath(path) {
 function getBrowserWrapperPath(profileName, browsersDir = BROWSERS_DIR) {
   return join(browsersDir, `${profileName}.sh`);
 }
+function renameBrowserWrapper(oldName, newName, browsersDir = BROWSERS_DIR) {
+  const oldPath = getBrowserWrapperPath(oldName, browsersDir);
+  if (!existsSync(oldPath)) {
+    return;
+  }
+  const newPath = getBrowserWrapperPath(newName, browsersDir);
+  renameSync(oldPath, newPath);
+}
 function removeBrowserWrapper(profileName, browsersDir = BROWSERS_DIR) {
   const wrapperPath = getBrowserWrapperPath(profileName, browsersDir);
   if (!existsSync(wrapperPath)) {
@@ -131,6 +139,18 @@ function removeProfile(name, configFile = CONFIG_FILE) {
   delete config.profiles[name];
   saveConfig(config, configFile);
 }
+function renameProfile(oldName, newName, configFile = CONFIG_FILE) {
+  const config = loadConfig(configFile);
+  if (!config.profiles[oldName]) {
+    throw new Error(`Profile "${oldName}" not found`);
+  }
+  if (config.profiles[newName]) {
+    throw new Error(`Profile "${newName}" already exists`);
+  }
+  config.profiles[newName] = { ...config.profiles[oldName], name: newName };
+  delete config.profiles[oldName];
+  saveConfig(config, configFile);
+}
 function getProfile(name, configFile = CONFIG_FILE) {
   return loadConfig(configFile).profiles[name];
 }
@@ -155,6 +175,17 @@ function createProfileDir(name, profilesDir = PROFILES_DIR) {
   mkdirSync(dir, { recursive: true });
   return dir;
 }
+function renameProfileDir(oldName, newName, profilesDir = PROFILES_DIR) {
+  const oldDir = join(profilesDir, oldName);
+  const newDir = join(profilesDir, newName);
+  if (!existsSync(oldDir)) {
+    throw new Error(`Profile directory "${oldName}" does not exist`);
+  }
+  if (existsSync(newDir)) {
+    throw new Error(`Profile directory "${newName}" already exists`);
+  }
+  renameSync(oldDir, newDir);
+}
 function removeProfileDir(name, profilesDir = PROFILES_DIR) {
   const dir = join(profilesDir, name);
   if (!existsSync(dir)) {
@@ -288,8 +319,6 @@ function getAuthStatus(profileDir) {
     });
   });
 }
-
-// src/lib/profile-store.ts
 function getProfileState(hasConfig, hasDirectory) {
   if (hasConfig && hasDirectory) return "ready";
   if (hasDirectory) return "orphaned";
@@ -383,6 +412,74 @@ function removeStoredProfile(name, configFile = CONFIG_FILE, profilesDir = PROFI
     throw error;
   }
 }
+function renameStoredProfile(oldName, newName, configFile = CONFIG_FILE, profilesDir = PROFILES_DIR, browsersDir = BROWSERS_DIR) {
+  validateProfileName(newName);
+  if (oldName === newName) {
+    throw new Error("Old and new profile names are the same");
+  }
+  const profile = getStoredProfile(oldName, configFile, profilesDir);
+  if (!profile) {
+    throw new Error(`Profile "${oldName}" does not exist`);
+  }
+  if (getProfile(newName, configFile)) {
+    throw new Error(`Profile "${newName}" already exists`);
+  }
+  if (profileExists(newName, profilesDir)) {
+    throw new Error(`Profile directory "${newName}" already exists`);
+  }
+  if (profile.hasDirectory) {
+    renameProfileDir(oldName, newName, profilesDir);
+  }
+  const hadWrapper = existsSync(getBrowserWrapperPath(oldName, browsersDir));
+  if (hadWrapper) {
+    try {
+      renameBrowserWrapper(oldName, newName, browsersDir);
+    } catch (error) {
+      try {
+        rollbackRename(oldName, newName, profile.hasDirectory, false, profilesDir, browsersDir);
+      } catch (rollbackError) {
+        throw new Error(
+          `Failed to rename profile "${oldName}" to "${newName}": ${formatError(error)}. Rollback failed: ${formatError(rollbackError)}`
+        );
+      }
+      throw error;
+    }
+  }
+  try {
+    renameProfile(oldName, newName, configFile);
+  } catch (error) {
+    try {
+      rollbackRename(oldName, newName, profile.hasDirectory, hadWrapper, profilesDir, browsersDir);
+    } catch (rollbackError) {
+      throw new Error(
+        `Failed to rename profile "${oldName}" to "${newName}": ${formatError(error)}. Rollback failed: ${formatError(rollbackError)}`
+      );
+    }
+    throw error;
+  }
+}
+function rollbackRename(oldName, newName, hadDirectory, hadWrapper, profilesDir, browsersDir) {
+  const rollbackErrors = [];
+  if (hadWrapper) {
+    try {
+      renameBrowserWrapper(newName, oldName, browsersDir);
+    } catch (error) {
+      rollbackErrors.push(`browser wrapper: ${formatError(error)}`);
+    }
+  }
+  if (hadDirectory) {
+    try {
+      renameProfileDir(newName, oldName, profilesDir);
+    } catch (error) {
+      rollbackErrors.push(`profile dir: ${formatError(error)}`);
+    }
+  }
+  if (rollbackErrors.length > 0) {
+    throw new Error(
+      `Rollback failed for rename "${oldName}" to "${newName}": ${rollbackErrors.join("; ")}`
+    );
+  }
+}
 function rollbackStorage(name, stagedDir, stagedWrapper, profilesDir, browsersDir) {
   const rollbackErrors = [];
   if (stagedDir) {
@@ -507,6 +604,19 @@ function registerRemove(program2) {
   });
 }
 
+// src/commands/rename.ts
+function registerRename(program2) {
+  program2.command("rename <old-name> <new-name>").description("Rename a profile").action((oldName, newName) => {
+    try {
+      renameStoredProfile(oldName, newName);
+      console.log(`\x1B[32m\u2713\x1B[0m Profile "${oldName}" renamed to "${newName}"`);
+    } catch (e) {
+      console.error(`\x1B[31m\u2717\x1B[0m ${e instanceof Error ? e.message : String(e)}`);
+      process.exit(1);
+    }
+  });
+}
+
 // src/commands/run.ts
 function registerRun(program2) {
   program2.command("run <name>").description("Run Claude Code with a prompt using a profile").requiredOption("-p, --prompt <prompt>", "Prompt to send").action((name, opts) => {
@@ -591,10 +701,11 @@ function registerUse(program2) {
 }
 
 // src/index.ts
-var program = new Command().name("ccm").version("0.1.0").description("Manage multiple Claude Code profiles");
+var program = new Command().name("ccm").version("0.3.0").description("Manage multiple Claude Code profiles");
 registerCreate(program);
 registerList(program);
 registerRemove(program);
+registerRename(program);
 registerLogin(program);
 registerStatus(program);
 registerUse(program);

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@remeic/ccm",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "nvm-like manager for Claude Code profiles",
   "license": "MIT",
   "author": "Giulio Fagioli",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/remeic/ccm-cli.git"
+    "url": "git+https://github.com/Remeic/ccm.git"
   },
   "bugs": {
-    "url": "https://github.com/remeic/ccm-cli/issues"
+    "url": "https://github.com/Remeic/ccm/issues"
   },
-  "homepage": "https://github.com/remeic/ccm-cli#readme",
+  "homepage": "https://github.com/Remeic/ccm#readme",
   "keywords": [
     "claude",
     "claude-code",
@@ -30,6 +30,7 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
+    "homebrew:formula": "node scripts/homebrew/generate-formula.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",