cchost 0.1.1 → 0.1.3

package/README.md

@@ -1,6 +1,6 @@
 # cchost
 
-Host multiple isolated Claude Code accounts on one machine via a single `cc` command. Works identically in PowerShell, cmd, bash, zsh, and fish on Windows, macOS, and Linux.
+Host multiple isolated Claude Code accounts on one machine via a single `cc` command. `cc` is a plain Node CLI on your PATH, so it runs the same from PowerShell, cmd, bash, zsh, or fish — there are no shell scripts or rc-file edits involved. Tested on Windows and Linux; macOS is expected to work but is not yet verified.
 
 Each profile is a complete, isolated `CLAUDE_CONFIG_DIR` — credentials, session history, project state, plugins, and settings. Create one with `cc add <name>`; launch under it with `cc use <name>`.
 
@@ -20,8 +20,8 @@ Requires Node.js 18+ and Claude Code 2.1.140+ already installed. Get Claude Code
 | `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, 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). |
 
@@ -66,7 +66,9 @@ cc link work
 cc link personal
 ```
 
-`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.
 

package/lib/cli.js

@@ -18,10 +18,11 @@ Usage:
   cc use <profile> [...args]                       Launch Claude under a named 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)
+  cc --version                                     Print the installed cchost version
 
 Profiles live in ~/.claude-profiles/<profile>/ and become CLAUDE_CONFIG_DIR
 for that launch. Args after the profile name are forwarded verbatim to claude.
@@ -61,8 +62,8 @@ Columns:
   Profile   - profile name
   LoggedIn  - true if .credentials.json exists
   Email     - account email (alias-aware; - if not yet logged in)
-  Storage   - 'shared' if projects/ or sessions/ is linked to ~/.claude-shared,
-              'isolated' otherwise
+  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.
@@ -71,8 +72,8 @@ 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)
@@ -90,9 +91,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.
@@ -102,8 +104,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>
 
@@ -111,8 +113,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]
 
@@ -272,9 +274,7 @@ function cmdList(rest) {
   const enriched = list.map((p) => {
     const alias = p.alias || {};
     const displayEmail = useOriginal ? p.email : (alias.email || p.email);
-    const projectsLink = isLinkLike(path.join(p.dir, 'projects'));
-    const sessionsLink = isLinkLike(path.join(p.dir, 'sessions'));
-    const storage = (projectsLink || sessionsLink) ? 'shared' : 'isolated';
+    const storage = isLinkLike(path.join(p.dir, 'projects')) ? 'shared' : 'isolated';
     return {
       name: p.name,
       dir: p.dir,
@@ -383,6 +383,11 @@ async function run(argv) {
     printHelp();
     return 0;
   }
+  if (action === '--version' || action === '-v') {
+    const { version } = require('../package.json');
+    process.stdout.write(version + '\n');
+    return 0;
+  }
   if (action === 'help') {
     printHelp(rest[0]);
     return 0;

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cchost",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Host multiple isolated Claude Code accounts on one machine via the `cc` command.",
   "keywords": [
     "claude",