cchost 0.1.0 → 0.1.2

package/README.md

@@ -18,11 +18,10 @@ Requires Node.js 18+ and Claude Code 2.1.140+ already installed. Get Claude Code
 | --- | --- |
 | `cc add <profile> [--email=] [--org=] [--name=]` | Create a profile directory. Optional alias flags (EXPERIMENTAL, see below). |
 | `cc use <profile> [...args]` | Launch Claude under that profile. Profile must already exist. Args after the name are forwarded verbatim to `claude`. |
-| `cc list [--original] [--json]` | Show every profile, login state, account email, active marker, and linked/isolated status. |
-| `cc current [--json]` | Print the active profile (`CC_ACTIVE_PROFILE`) or "no profile active". |
+| `cc list [--original] [--json]` | Show every profile: login state, account email, and storage mode (`shared` / `isolated`). |
 | `cc migrate <src> <dest>` | Copy projects from `default`\|`shared` to `shared`\|`<profile>`. Skip-on-collision; credential files never copied. |
-| `cc link <profile> [<profile>...]` | Link a profile's `projects/` and `sessions/` to `~/.claude-shared`. Migrates existing content; renames on collision. |
-| `cc unlink <profile>` | Restore a profile to its own private `projects/` and `sessions/` (copies shared content back). |
+| `cc link <profile> [<profile>...]` | Link a profile's `projects/` to `~/.claude-shared/projects`. Migrates existing content; renames on collision. |
+| `cc unlink <profile>` | Restore a profile to its own private `projects/` (copies shared content back). |
 | `cc remove <profile>` | Delete a profile. Requires typing the profile name to confirm. |
 | `cc help [command]` | Print usage (top-level, or for a single command). |
 
@@ -34,10 +33,18 @@ cc use work                            # first launch: Claude prompts for login
 cc use work --resume                   # resume last conversation under "work"
 cc use personal -p "summarize"         # one-shot prompt under "personal"
 cc list
-cc current
 cc remove old-profile
 ```
 
+`cc list` output:
+
+```
+Profile   LoggedIn  Email                 Storage
+personal  true      personal@example.com  isolated
+scratch   false     -                     isolated
+work      true      work@example.com      shared
+```
+
 ### Migrating existing projects
 
 If you've been using Claude Code without profiles, your history lives in `~/.claude/projects/`. Pull it into a profile or the shared pool:
@@ -57,10 +64,11 @@ If you want each profile to keep separate credentials but share project history
 ```bash
 cc link work
 cc link personal
-cc list                        # the Linked column shows "linked" vs "isolated"
 ```
 
-`work/projects` and `personal/projects` become links to `~/.claude-shared/projects`. Same for `sessions/`. On Windows this uses directory junctions (no admin/Developer Mode required); on macOS/Linux, regular symlinks.
+`work/projects` and `personal/projects` become links to `~/.claude-shared/projects`. On Windows this uses directory junctions (no admin/Developer Mode required); on macOS/Linux, regular symlinks.
+
+**Only `projects/` is shared.** That's the directory Claude Code uses for resumable conversation transcripts (`projects/<project>/<session>.jsonl`). The sibling `sessions/` folder holds transient per-process registry state — PID, working directory, status, timestamps — and is **never** linked, migrated, or copied across profiles. Sharing it would corrupt Claude's running-process bookkeeping. `sessions/` stays per-profile under `~/.claude-profiles/<name>/sessions/`.
 
 `cc link a b c` links several profiles at once; per-profile failures are reported but don't abort the rest of the batch.
 
@@ -80,11 +88,11 @@ If two profiles share history and you launch them against the same project at th
 
 1. Resolves the profile directory under `~/.claude-profiles/<name>/`
 2. Applies any stored alias to `.claude.json` `oauthAccount` (best-effort)
-3. Sets `CLAUDE_CONFIG_DIR` and `CC_ACTIVE_PROFILE` in its **own** spawn environment
+3. Sets `CLAUDE_CONFIG_DIR` in its **own** spawn environment
 4. Spawns `claude` with `stdio: 'inherit'` so the TUI works correctly
 5. Forwards the child's exit code
 
-The env vars are set on the child process only — that's all `claude` needs.
+The env var is set on the child process only — that's all `claude` needs.
 
 ## Sensitive data
 
@@ -104,9 +112,6 @@ Earlier versions had bugs where Windows read `.claude.json` from `%USERPROFILE%`
 **Profile name rejected**
 Names must be free of path separators, whitespace, `..`, leading dots, and reserved DOS names (CON, PRN, COM1…). Stick to letters, digits, dashes, underscores.
 
-**`cc current` says no profile is active inside a Claude session**
-That means `CC_ACTIVE_PROFILE` isn't set in your shell — `cc use` sets it on the spawned `claude`, so it's visible to nested `cc current` invocations but not in unrelated shells.
-
 **Old shell-script version was leaking keystrokes / leaking `use work` into the prompt**
 That was a known bug in the cmd-based predecessor (`%*` ignored `shift`). This package forwards only the argv after `<profile>` to `claude`; the action and profile name themselves are consumed by `cc`.
 

package/lib/cli.js

@@ -16,11 +16,10 @@ const HELP = `cc - Multi-profile launcher for Claude Code
 Usage:
   cc add <profile> [--email=] [--org=] [--name=]   Create a profile (EXPERIMENTAL aliases)
   cc use <profile> [...args]                       Launch Claude under a named profile
-  cc list [--original] [--json]                    Show all profiles, login state, email, active, linked
-  cc current [--json]                              Show the active profile (from CC_ACTIVE_PROFILE)
+  cc list [--original] [--json]                    Show all profiles: login state, email, storage (shared/isolated)
   cc migrate <src> <dest>                          Copy projects from default|shared to shared|<profile>
-  cc link <p>...                                   Replace each profile's projects/sessions with links to shared
-  cc unlink <profile>                              Restore a profile's private projects/sessions
+  cc link <p>...                                   Replace each profile's projects/ with a link to shared
+  cc unlink <profile>                              Restore a profile's private projects/
   cc remove <profile>                              Delete a profile and all its data (typed confirmation)
   cc help [command]                                Show usage (optionally for a single command)
 
@@ -58,28 +57,22 @@ Examples:
 `,
   list: `cc list [--original] [--json]
 
-Show every profile under ~/.claude-profiles/, whether it has credentials, the
-account email, which one matches CC_ACTIVE_PROFILE, and whether the profile
-is linked to ~/.claude-shared.
+Columns:
+  Profile   - profile name
+  LoggedIn  - true if .credentials.json exists
+  Email     - account email (alias-aware; - if not yet logged in)
+  Storage   - 'shared' if projects/ is linked to ~/.claude-shared, 'isolated' otherwise
+              (sessions/ is transient per-process state and is never shared)
 
 By default, the displayed email reflects any alias set via 'cc add'.
 With --original, shows the real value from .claude.json.
 
-With --json, emits an array of
-{name, dir, loggedIn, email, active, linked, shared:{projects, sessions}, alias}.
-`,
-  current: `cc current [--json]
-
-Print the value of CC_ACTIVE_PROFILE, or "no profile active" if it isn't set.
-CC_ACTIVE_PROFILE is set by 'cc use' on the spawned claude, so nested cc
-invocations see it.
-
-With --json, emits {profile, configDir} (both null when nothing is active).
+With --json, emits an array of {name, dir, loggedIn, email, storage, alias}.
 `,
   migrate: `cc migrate <src> <dest>
 
-Copy projects/ (and sessions/ if present) from a source to a destination.
-This is a COPY — the source is left untouched.
+Copy projects/ from a source to a destination. sessions/ (transient per-process
+registry state) is never migrated. This is a COPY — the source is left untouched.
 
   <src>:   default | shared
            default = ~/.claude/        (Claude's built-in non-profile data)
@@ -97,9 +90,10 @@ Examples:
 `,
   link: `cc link <profile> [<profile>...]
 
-Replace each profile's projects/ and sessions/ with links to ~/.claude-shared.
+Replace each profile's projects/ with a link to ~/.claude-shared/projects/.
 Existing content is migrated into shared first; collisions are renamed with a
-__<profile> suffix (never overwritten).
+__<profile> suffix (never overwritten). sessions/ (transient per-process state)
+is intentionally never linked — it stays per-profile.
 
 On Windows, link uses directory junctions (no admin/Developer Mode needed).
 On macOS/Linux, regular symlinks.
@@ -109,8 +103,8 @@ are reported but don't abort the rest of the batch.
 `,
   unlink: `cc unlink <profile>
 
-Remove a profile's links to ~/.claude-shared/ and copy shared content back
-into the profile as private dirs.
+Remove a profile's projects/ link to ~/.claude-shared/ and copy shared content
+back into the profile as a private dir.
 `,
   remove: `cc remove <profile>
 
@@ -118,8 +112,8 @@ Delete a profile and everything inside its directory: credentials, sessions,
 projects, plugins, and history. To confirm, you must type the exact profile
 name — y/n is intentionally not accepted because credential loss is unrecoverable.
 
-If the profile's projects/ or sessions/ is a link to ~/.claude-shared/, only
-the link is removed — the shared target is preserved.
+If the profile's projects/ is a link to ~/.claude-shared/, only the link is
+removed — the shared target is preserved.
 `,
   help: `cc help [command]
 
@@ -268,61 +262,30 @@ async function cmdUse(rest) {
   return spawnClaude({
     args: passthrough,
     profileDir: dir,
-    activeProfile: name,
   });
 }
 
-function cmdCurrent(rest) {
-  const { flags } = parseFlagsStrict(rest, ['--json']);
-  const value = process.env.CC_ACTIVE_PROFILE || '';
-  if (flags.has('--json')) {
-    const payload = value
-      ? { profile: value, configDir: process.env.CLAUDE_CONFIG_DIR || profiles.profileDir(value) }
-      : { profile: null, configDir: null };
-    process.stdout.write(JSON.stringify(payload) + '\n');
-    return 0;
-  }
-  console.log(value ? value : 'no profile active');
-  return 0;
-}
-
 function cmdList(rest) {
   const { flags } = parseFlagsStrict(rest, ['--json', '--original']);
   const list = profiles.listProfiles();
-  const active = process.env.CC_ACTIVE_PROFILE || '';
   const useOriginal = flags.has('--original');
 
   const enriched = list.map((p) => {
-    const projectsLink = isLinkLike(path.join(p.dir, 'projects'));
-    const sessionsLink = isLinkLike(path.join(p.dir, 'sessions'));
-    const linked = projectsLink || sessionsLink;
     const alias = p.alias || {};
     const displayEmail = useOriginal ? p.email : (alias.email || p.email);
+    const storage = isLinkLike(path.join(p.dir, 'projects')) ? 'shared' : 'isolated';
     return {
       name: p.name,
       dir: p.dir,
       loggedIn: p.loggedIn,
       email: displayEmail,
-      realEmail: p.email,
-      active: p.name === active,
-      linked,
-      shared: { projects: projectsLink, sessions: sessionsLink },
+      storage,
       alias,
     };
   });
 
   if (flags.has('--json')) {
-    const payload = enriched.map((p) => ({
-      name: p.name,
-      dir: p.dir,
-      loggedIn: p.loggedIn,
-      email: p.email,
-      active: p.active,
-      linked: p.linked,
-      shared: p.shared,
-      alias: p.alias,
-    }));
-    process.stdout.write(JSON.stringify(payload, null, 2) + '\n');
+    process.stdout.write(JSON.stringify(enriched, null, 2) + '\n');
     return 0;
   }
 
@@ -332,14 +295,13 @@ function cmdList(rest) {
     return 0;
   }
 
-  const rows = [['Profile', 'LoggedIn', 'Email', 'Active', 'Linked']];
+  const rows = [['Profile', 'LoggedIn', 'Email', 'Storage']];
   for (const p of enriched) {
     rows.push([
       p.name,
       p.loggedIn ? 'true' : 'false',
-      p.email || '',
-      p.active ? color.stdout.green('*') : '',
-      p.linked ? 'linked' : 'isolated',
+      p.email ? p.email : '-',
+      p.storage,
     ]);
   }
   console.log(renderTable(rows));
@@ -359,9 +321,6 @@ async function cmdRemove(rest) {
   console.log('This will permanently delete:');
   console.log(`  ${dir}`);
   console.log('including credentials, sessions, projects, plugins, and history.');
-  if (name === process.env.CC_ACTIVE_PROFILE) {
-    console.log(color.stderr.yellow(`Note: "${name}" is the currently active profile in this shell.`));
-  }
   for (const sub of share.SHARED_SUBDIRS) {
     const sub_p = path.join(dir, sub);
     if (isLinkLike(sub_p)) {
@@ -379,9 +338,6 @@ async function cmdRemove(rest) {
     throw new Error(`Failed to fully remove ${dir}: ${err.message}`);
   }
   console.log(`Removed ${dir}.`);
-  if (name === process.env.CC_ACTIVE_PROFILE) {
-    console.log('Note: the active profile in this shell no longer exists; run `cc use <name>` to switch.');
-  }
   return 0;
 }
 
@@ -437,8 +393,6 @@ async function run(argv) {
       return await cmdUse(rest);
     case 'list':
       return cmdList(rest);
-    case 'current':
-      return cmdCurrent(rest);
     case 'migrate':
       return await cmdMigrate(rest);
     case 'link':

package/lib/migrate.js

@@ -6,7 +6,9 @@ const os = require('os');
 
 const profiles = require('./profiles');
 
-const SUBDIRS = ['projects', 'sessions'];
+// Only projects/ holds the resumable conversation transcripts. sessions/ is transient
+// per-process state and is intentionally not migrated.
+const SUBDIRS = ['projects'];
 const EXCLUDED_FILES = new Set(['.credentials.json', '.claude.json']);
 
 function defaultClaudeDir() {

package/lib/share.js

@@ -5,7 +5,10 @@ const path = require('path');
 
 const profiles = require('./profiles');
 
-const SHARED_SUBDIRS = ['projects', 'sessions'];
+// Only projects/ holds the resumable conversation transcripts (projects/<proj>/<session>.jsonl).
+// sessions/ is transient per-process registry state (PID, cwd, status, timestamps) and
+// must stay per-profile — sharing it would corrupt Claude's running-process bookkeeping.
+const SHARED_SUBDIRS = ['projects'];
 
 function symlinkType() {
   return process.platform === 'win32' ? 'junction' : 'dir';

package/lib/spawn.js

@@ -155,7 +155,7 @@ function platformSpawn(bin, args, opts) {
   return spawn(bin, args, opts);
 }
 
-function spawnClaude({ args = [], profileDir = null, activeProfile = null, extraEnv = {} } = {}) {
+function spawnClaude({ args = [], profileDir = null, extraEnv = {} } = {}) {
   const bin = findClaude();
   if (!bin) {
     const err = new Error(
@@ -174,11 +174,6 @@ function spawnClaude({ args = [], profileDir = null, activeProfile = null, extra
   } else {
     delete childEnv.CLAUDE_CONFIG_DIR;
   }
-  if (activeProfile) {
-    childEnv.CC_ACTIVE_PROFILE = activeProfile;
-  } else {
-    delete childEnv.CC_ACTIVE_PROFILE;
-  }
 
   return new Promise((resolve) => {
     let child;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cchost",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Host multiple isolated Claude Code accounts on one machine via the `cc` command.",
   "keywords": [
     "claude",
@@ -43,4 +43,4 @@
   "devDependencies": {
     "vitest": "^2.1.0"
   }
-}
+}