cchost 0.4.4 → 0.5.0

package/lib/cli.js

@@ -13,19 +13,24 @@ const { renderTable } = require('./format');
 const color = require('./color');
 const { renderBanner } = require('./banner');
 
-const HELP = `cc - Multi-profile launcher for Claude Code
+const HELP = `cchost - Multi-profile launcher for Claude Code
+
+Installed as both 'cchost' (preferred) and 'cc' (legacy alias). The examples
+below use cchost; prefer it in scripts because 'cc' shadows the system C
+compiler on macOS and Linux.
 
 Usage:
-  cc add <profile> [--custom [...]]                Create a profile (auto-links all 7 resources to ~/.claude/)
-  cc use <profile> [...args]                       Launch Claude under a named profile
-  cc list [<profile>] [--json] [--reveal]          List profiles, or show one in detail
-  cc copy default <profile> [--force]              Copy ~/.claude/ resources into a profile (only when unlinked)
-  cc link <p>... [--projects|--tools|--config]     (Re-)link a profile's resources to ~/.claude/
-  cc unlink <profile> [--projects|--tools|--config]  Restore a profile's private resources (non-destructive)
-  cc remove <profile> [--force]                    Delete a profile and all its data
-  cc doctor [--fix [--force]] [--json]             Diagnose environment, storage, and platform issues
-  cc help [command]                                Show usage (optionally for a single command)
-  cc --version                                     Print the installed cchost version
+  cchost add <profile> [--custom [...]]                Create a profile (auto-links all 7 resources to ~/.claude/)
+  cchost use <profile> [...args]                       Launch Claude under a named profile
+  cchost list [<profile>] [--json] [--reveal]          List profiles, or show one in detail
+  cchost copy default <profile> [--force] [--dry-run]  Copy ~/.claude/ resources into a profile (only when unlinked)
+  cchost link <p>... [--projects|--tools|--config]     (Re-)link a profile's resources to ~/.claude/
+  cchost unlink <profile> [--projects|--tools|--config]  Restore a profile's private resources (non-destructive)
+  cchost remove <profile> [--force]                    Delete a profile and all its data
+  cchost doctor [--fix [--force]] [--json]             Diagnose environment, storage, and platform issues
+  cchost help [command]                                Show usage (optionally for a single command)
+  cchost help sharing                                  Task guide: what is shared, and how to change it
+  cchost --version                                     Print the installed cchost version
 
 Shared resources (linked into ~/.claude/ by default):
   --projects   projects/                                 (session history)
@@ -35,35 +40,37 @@ Shared resources (linked into ~/.claude/ by default):
 Never shared (stay per-profile):
   .credentials.json  .claude.json  .cc-env.json          (identity / auth)
 
+link, unlink, and copy accept --dry-run to preview changes without making them.
+
 Profiles live in ~/.claude-profiles/<profile>/ and become CLAUDE_CONFIG_DIR
 for that launch. Args after the profile name are forwarded verbatim to claude.
 `;
 
 const HELP_BY_CMD = {
-  add: `cc add <profile> [--custom [--base-url=URL --token=TOKEN ...]]
+  add: `cchost add <profile> [--custom [--base-url=URL --token=TOKEN ...]]
 
 Create a new profile directory without launching Claude. All 7 shared
 resources (projects/, skills/, agents/, commands/, mcp.json, settings.json,
 CLAUDE.md) are auto-linked into ~/.claude/ so they're visible to every
 profile (and to bare \`claude\`) from the moment the profile is created.
 
-  cc add <profile>
+  cchost add <profile>
       Create a regular profile. It logs in with your Anthropic
-      subscription (OAuth) on the first 'cc use'.
+      subscription (OAuth) on the first 'cchost use'.
 
-  cc add <profile> --custom
+  cchost add <profile> --custom
       Create a profile routed through a custom, Anthropic-compatible API
       endpoint — Moonshot/Kimi, OpenRouter, a self-hosted vLLM, a corporate
       proxy, and so on. Opens an interactive wizard; the API token is never
       echoed to the screen.
 
-  cc add <profile> --custom --base-url=URL --token=TOKEN
+  cchost add <profile> --custom --base-url=URL --token=TOKEN
                           [--model=NAME] [--opus=NAME] [--sonnet=NAME]
                           [--haiku=NAME] [--subagent=NAME]
       Same, non-interactive. --base-url and --token are required.
 
-Re-running 'cc add <profile> --custom' on an existing endpoint profile EDITS
-its configuration. View any profile with 'cc list <profile>'.
+Re-running 'cchost add <profile> --custom' on an existing endpoint profile EDITS
+its configuration. View any profile with 'cchost list <profile>'.
 
 Billing: a custom-endpoint profile bills through the third-party provider,
 NOT your Anthropic subscription. A profile is born subscription or endpoint
@@ -73,31 +80,32 @@ The endpoint config lives at ~/.claude-profiles/<profile>/.cc-env.json with
 user-only permissions. It is never linked and never copied.
 
 Examples:
-  cc add work
-  cc add kimi --custom
-  cc add kimi --custom --base-url=https://api.moonshot.ai/anthropic --token=sk-... --model=kimi-k2.5
+  cchost add work
+  cchost add kimi --custom
+  cchost add kimi --custom --base-url=https://api.moonshot.ai/anthropic --token=sk-... --model=kimi-k2.5
 `,
-  use: `cc use <profile> [...args]
+  use: `cchost use <profile> [...args]
 
 Launch Claude under a named profile. The profile must already exist (create
-it with 'cc add <profile>'). Its directory under ~/.claude-profiles/<profile>/
+it with 'cchost add <profile>'). Its directory under ~/.claude-profiles/<profile>/
 becomes CLAUDE_CONFIG_DIR for the spawned claude — credentials and per-
 profile config are isolated; the 7 shared resources are visible via symlinks.
 
 All args after the profile name are forwarded verbatim to claude.
 
 Examples:
-  cc use work
-  cc use work --resume
-  cc use personal -p "summarize this codebase"
+  cchost use work
+  cchost use work --resume
+  cchost use personal -p "summarize this codebase"
 `,
-  list: `cc list [<profile>] [--json] [--reveal]
+  list: `cchost list [<profile>] [--json] [--reveal]
 
 Without a profile name: list every profile as a table.
 
 Columns:
   Profile   - profile name
-  LoggedIn  - true if .credentials.json exists
+  LoggedIn  - true if credentials are present. On macOS the token lives in the
+              login Keychain and the login is inferred from .claude.json.
   Email     - account email from .claude.json (masked by default; pass
               --reveal to show the full value); - if not yet logged in
   Shared    - N/7 resources linked to ~/.claude/. 7/7 = fully shared (the
@@ -105,23 +113,24 @@ Columns:
   Endpoint  - custom-endpoint host from .cc-env.json, or "subscription" if
               the profile uses Anthropic's subscription OAuth
 
-With a profile name: print that one profile's detail, including its custom
-endpoint configuration if it has one. The API token is masked by default;
+With a profile name: print that one profile's detail: the state of each of
+the 7 resources (shared, private, empty, missing, or foreign-link) and its
+custom endpoint configuration if it has one. The API token is masked by default;
 --reveal prints both the token and the full email — do not paste that output
 anywhere.
 
-  cc list                            Table of all profiles (emails masked)
-  cc list --reveal                   Table with full emails shown
-  cc list --json                     Same, as a JSON array (always masked)
-  cc list <profile>                  Detail for a single profile
-  cc list <profile> --reveal         Detail with the full token + email shown
-  cc list <profile> --json           Detail as a JSON object (always masked)
+  cchost list                            Table of all profiles (emails masked)
+  cchost list --reveal                   Table with full emails shown
+  cchost list --json                     Same, as a JSON array (always masked)
+  cchost list <profile>                  Detail for a single profile
+  cchost list <profile> --reveal         Detail with the full token + email shown
+  cchost list <profile> --json           Detail as a JSON object (always masked)
 `,
-  copy: `cc copy default <profile> [--force]
+  copy: `cchost copy default <profile> [--force] [--dry-run]
 
 Copy ~/.claude/ resources into a profile. Useful only when the profile has
 'unlinked' one or more resources (private content); for fresh v0.4.1
-profiles every resource is symlinked, so 'cc copy' is a no-op.
+profiles every resource is symlinked, so 'cchost copy' is a no-op.
 
   <src>:   default  (= ~/.claude/, Claude Code's own config dir)
   <dest>:  <profile-name>
@@ -135,32 +144,44 @@ For each resource:
   - If the destination is shared via symlink/hard-link to the source → skipped
   - Else, copy with skip-on-collision (entries already at the destination win)
 
---force  Overwrite collisions at the destination instead of skipping.
+--force    Overwrite collisions at the destination instead of skipping.
+--dry-run  Print what would be copied, skipped, or overwritten; change nothing.
 
 Examples:
-  cc copy default work               # only acts on unlinked resources
-  cc copy default work --force       # overwrite collisions
+  cchost copy default work --dry-run     # preview first
+  cchost copy default work               # only acts on unlinked resources
+  cchost copy default work --force       # overwrite collisions
 
 Removed in v0.4: 'shared' as src/dest. The shared pool IS ~/.claude/ in v0.4
-and is reached via symlinks. Use 'cc link' / 'cc unlink' to manage sharing.
-Note: 'cc migrate' is a deprecated alias for 'cc copy' — it still works but
+and is reached via symlinks. Use 'cchost link' / 'cchost unlink' to manage sharing.
+Note: 'cchost migrate' is a deprecated alias for 'cchost copy' — it still works but
 will be removed in a future version.
 `,
-  link: `cc link <profile> [<profile>...] [--projects|--tools|--config]
+  migrate: `cchost migrate <src> <dest> [--force]
+
+Deprecated alias for 'cchost copy'. It prints a deprecation warning and
+forwards its arguments. Use 'cchost copy' instead; this alias will be removed
+in a future version.
 
-(Re-)link a profile's resources into the shared pool at ~/.claude/. 'cc add'
-already does this for new profiles; 'cc link' is for re-applying it after
-'cc unlink' or for older profiles that pre-date v0.4.1.
+Examples:
+  cchost migrate default work
+`,
+  link: `cchost link <profile> [<profile>...] [--projects|--tools|--config] [--dry-run]
+
+(Re-)link a profile's resources into the shared pool at ~/.claude/. 'cchost add'
+already does this for new profiles; 'cchost link' is for re-applying it after
+'cchost unlink' or for older profiles that pre-date v0.4.1.
 
 No flag         link all 7 resources
 --projects      projects/
 --tools         skills/, agents/, commands/
 --config        mcp.json, settings.json, CLAUDE.md
 (flags can be combined: --tools --config)
+--dry-run       print what would be linked or refused; change nothing
 
 Refuses to overwrite private content: if the profile has a non-empty resource
 that isn't already a symlink, that resource is reported as 'refused' and left
-alone — move or remove it manually, then re-run 'cc link'. The other
+alone — move or remove it manually, then re-run 'cchost link'. The other
 resources are still linked.
 
 On Windows, dirs use junctions (no admin/Developer Mode needed). File
@@ -168,12 +189,13 @@ symlinks may require Developer Mode; without it, files fall back to hard
 links so editing-in-place still propagates between profiles.
 
 Examples:
-  cc link work                     # link all 7
-  cc link work --tools             # only skills/, agents/, commands/
-  cc link work --config            # only mcp.json, settings.json, CLAUDE.md
-  cc link a b c                    # link 3 profiles in one shot
+  cchost link work                     # link all 7
+  cchost link work --tools             # only skills/, agents/, commands/
+  cchost link work --config            # only mcp.json, settings.json, CLAUDE.md
+  cchost link a b c                    # link 3 profiles in one shot
+  cchost link work --dry-run           # preview
 `,
-  unlink: `cc unlink <profile> [--projects|--tools|--config]
+  unlink: `cchost unlink <profile> [--projects|--tools|--config] [--dry-run]
 
 Break the symlinks and copy current ~/.claude/ content into the profile as
 private resources. Non-destructive: same-name items already private in the
@@ -183,16 +205,50 @@ No flag         unlink all 7 resources
 --projects      projects/
 --tools         skills/, agents/, commands/
 --config        mcp.json, settings.json, CLAUDE.md
+--dry-run       print what would be unlinked and copied; change nothing
 
 After unlinking, the profile's resource diverges from ~/.claude/. Other
 profiles still see the shared pool.
 
 Examples:
-  cc unlink work                   # full private profile
-  cc unlink work --config          # only mcp.json / settings.json / CLAUDE.md private
-  cc unlink work --tools --config  # skills, agents, commands AND config private
+  cchost unlink work                   # full private profile
+  cchost unlink work --config          # only mcp.json / settings.json / CLAUDE.md private
+  cchost unlink work --tools --config  # skills, agents, commands AND config private
+  cchost unlink work --dry-run         # preview
 `,
-  remove: `cc remove <profile> [--force]
+  sharing: `cchost help sharing — what profiles share, and how to change it
+
+Every profile has 7 resources. By default each one is a link into ~/.claude/,
+so all profiles (and bare \`claude\`) see the same content:
+
+  --projects   projects/                              session history
+  --tools      skills/  agents/  commands/            user tooling
+  --config     mcp.json  settings.json  CLAUDE.md     MCP servers, settings, memory
+
+Logins (.credentials.json, .claude.json, .cc-env.json) are never shared.
+
+See where a profile stands:
+  cchost list                          Shared column: 7/7 = all shared
+  cchost list work                     state of each resource
+
+Make something private to one profile:
+  cchost unlink work --config          own mcp.json / settings.json / CLAUDE.md
+  cchost unlink work                   all 7 private
+  The current shared content is copied in, so nothing disappears; from then
+  on, changes in that profile stay in that profile.
+
+Share it again:
+  cchost link work --config            back to the shared ~/.claude/ copy
+  link refuses to replace private content. Move or delete the private file or
+  folder first; it is not merged into ~/.claude/ automatically.
+
+Copy shared content into a private profile (top-up, no overwrite):
+  cchost copy default work             add what ~/.claude/ has and work lacks
+  cchost copy default work --force     overwrite work's copies instead
+
+Preview any of these first with --dry-run.
+`,
+  remove: `cchost remove <profile> [--force]
 
 Delete a profile and everything inside its directory: credentials, sessions,
 and any private resources. To confirm, you must type the exact profile name —
@@ -203,7 +259,7 @@ removed — the shared content in ~/.claude/ is preserved for other profiles.
 If any resource is PRIVATE (unlinked), --force is required because its
 content is unique to this profile and will be lost forever.
 `,
-  doctor: `cc doctor [--fix [--force]] [--json]
+  doctor: `cchost doctor [--fix [--force]] [--json]
 
 Run diagnostic checks across four groups:
 
@@ -213,7 +269,7 @@ Run diagnostic checks across four groups:
                ~/.claude-shared/ folded into ~/.claude/ if still present
   Platform     Windows: OneDrive home, WindowsApps stub, stale ~/bin/cc;
                Git Bash: cygpath
-  Sanity       Test-spawn claude --version through the same code path cc use uses
+  Sanity       Test-spawn claude --version through the same code path cchost use uses
 
 Exit codes: 0 = all ok, 1 = warnings, 2 = errors.
 
@@ -223,7 +279,7 @@ Exit codes: 0 = all ok, 1 = warnings, 2 = errors.
                 .claude.json)
 --json          Machine-readable output for CI / scripting
 `,
-  help: `cc help [command]
+  help: `cchost help [command]
 
 Without an argument: print the summary of all commands.
 With a command name: print detail for just that command.
@@ -247,11 +303,11 @@ function printHelp(cmd) {
   process.stdout.write(HELP);
 }
 
-function prompt(question) {
+function prompt(question, output = process.stdout) {
   return new Promise((resolve) => {
     const rl = readline.createInterface({
       input: process.stdin,
-      output: process.stdout,
+      output,
     });
     rl.question(question, (answer) => {
       rl.close();
@@ -316,6 +372,18 @@ function parseFlagsStrict(args, flagNames, { allowPositional = false } = {}) {
   return { flags, positional };
 }
 
+function resourceLabel(resource) {
+  return share.isFileResource(resource) ? resource : `${resource}/`;
+}
+
+// One-line explanation per resource state for `cchost list <profile>`.
+const RESOURCE_STATE_NOTES = {
+  private: 'only this profile sees it',
+  empty: 'private, but empty',
+  missing: 'not set up; cchost link creates it',
+  'foreign-link': 'points outside ~/.claude/; cchost leaves it alone',
+};
+
 // Count how many of the 7 shared resources a profile currently has linked
 // (symlink OR — on Windows file fallback — hard link).
 function countSharedResources(profileDir) {
@@ -326,7 +394,7 @@ function countSharedResources(profileDir) {
   return n;
 }
 
-// Flag name -> .cc-env.json field, for `cc add --custom`.
+// Flag name -> .cc-env.json field, for `cchost add --custom`.
 const ENDPOINT_VALUE_FLAGS = {
   '--base-url': 'base_url',
   '--token': 'auth_token',
@@ -364,15 +432,15 @@ async function cmdAdd(rest) {
 
   const [name, ...extra] = positional;
   if (!name) {
-    throw usageError('Usage: cc add <profile> [--custom [--base-url=URL --token=TOKEN ...]]');
+    throw usageError('Usage: cchost add <profile> [--custom [--base-url=URL --token=TOKEN ...]]');
   }
-  if (extra.length > 0) throw usageError(`cc add takes no extra arguments: ${extra[0]}`);
+  if (extra.length > 0) throw usageError(`cchost add takes no extra arguments: ${extra[0]}`);
   profiles.validateProfileName(name);
 
   if (Object.keys(provided).length > 0 && !custom) {
     throw usageError(
       'Endpoint flags (--base-url, --token, --model, ...) require --custom: ' +
-        `cc add ${name} --custom ...`,
+        `cchost add ${name} --custom ...`,
     );
   }
 
@@ -383,7 +451,7 @@ async function cmdAdd(rest) {
     const { dir } = profiles.addProfile(name);
     console.log(`Created profile "${name}" at ${dir}.`);
     autoLinkArtifacts(name);
-    console.log(`Next: cc use ${name}`);
+    console.log(`Next: cchost use ${name}`);
     return 0;
   }
 
@@ -417,7 +485,7 @@ async function cmdAdd(rest) {
     return result.code;
   }
 
-  if (!existed) console.log(`Next: cc use ${name}`);
+  if (!existed) console.log(`Next: cchost use ${name}`);
   return result.code;
 }
 
@@ -448,8 +516,8 @@ function runLegacyPoolMigration() {
 }
 
 // On profile creation, symlink all 7 resources into ~/.claude/. Failures emit
-// a warning but do NOT abort cc add — the profile is still usable, and the
-// user can re-run `cc link <name>` to retry.
+// a warning but do NOT abort cchost add — the profile is still usable, and the
+// user can re-run `cchost link <name>` to retry.
 function autoLinkArtifacts(name) {
   let results;
   try {
@@ -462,7 +530,9 @@ function autoLinkArtifacts(name) {
     );
     return;
   }
-  const failed = results.filter((r) => r.status === 'failed' || r.status === 'refused');
+  const failed = results.filter(
+    (r) => r.status === 'failed' || r.status === 'refused' || r.status === 'foreign-link',
+  );
   const linked = results.length - failed.length;
   if (failed.length === 0) {
     console.log(`  Linked ${linked}/${results.length} resources to ~/.claude/.`);
@@ -476,35 +546,51 @@ function autoLinkArtifacts(name) {
   }
   process.stderr.write(
     color.stderr.yellow(
-      `  Re-run \`cc link ${name}\` after resolving the above.`,
+      `  Re-run \`cchost link ${name}\` after resolving the above.`,
     ) + '\n',
   );
 }
 
 async function cmdUse(rest) {
   const [name, ...passthrough] = rest;
-  if (!name) throw usageError('Usage: cc use <profile> [...args]');
+  if (!name) throw usageError('Usage: cchost use <profile> [...args]');
   profiles.validateProfileName(name);
   const dir = profiles.profileDir(name);
   if (!fs.existsSync(dir)) {
-    const err = new Error(`Profile "${name}" does not exist. Create it with: cc add ${name}`);
+    const err = new Error(`Profile "${name}" does not exist. Create it with: cchost add ${name}`);
     err.exitCode = 1;
     throw err;
   }
 
   let extraEnv = {};
+  let unsetEnv = [];
   const envConfig = envLib.readEnvConfig(dir);
   if (envConfig) {
     extraEnv = envLib.buildEnvVars(envConfig);
+    unsetEnv = envLib.endpointEnvToStrip(extraEnv);
     const host = envConfig.base_url ? envLib.hostOf(envConfig.base_url) : '(unknown)';
     process.stderr.write(
       `[cchost] Profile '${name}' → ${host} (custom endpoint billing applies)\n`,
     );
+    if (unsetEnv.length > 0) {
+      process.stderr.write(
+        `[cchost] notice: removed inherited ${unsetEnv.join(', ')} for endpoint profile '${name}'.\n`,
+      );
+    }
+  } else {
+    const conflicts = envLib.authEnvConflicts();
+    if (conflicts.length > 0) {
+      process.stderr.write(
+        `[cchost] warning: ${conflicts.join(', ')} set in the environment; ` +
+          `this may override the subscription login for '${name}'. ` +
+          `Unset ${conflicts.length > 1 ? 'them' : 'it'} to use the profile's login.\n`,
+      );
+    }
   }
-  return spawnClaude({ args: passthrough, profileDir: dir, extraEnv });
+  return spawnClaude({ args: passthrough, profileDir: dir, extraEnv, unsetEnv });
 }
 
-// `cc list <profile>` — detail for a single profile, including its custom
+// `cchost list <profile>` — detail for a single profile, including its custom
 // endpoint configuration if it has one.
 function cmdListOne(name, { json, reveal }) {
   if (json && reveal) {
@@ -513,15 +599,16 @@ function cmdListOne(name, { json, reveal }) {
   profiles.validateProfileName(name);
   const dir = profiles.profileDir(name);
   if (!fs.existsSync(dir)) {
-    const e = new Error(`Profile "${name}" does not exist. Create it with: cc add ${name}`);
+    const e = new Error(`Profile "${name}" does not exist. Create it with: cchost add ${name}`);
     e.exitCode = 1;
     throw e;
   }
 
   const total = share.SHARED_RESOURCES.length;
-  const sharedCount = countSharedResources(dir);
-  const loggedIn = profiles.hasCredentials(dir);
-  const email = profiles.readEmail(dir);
+  const resources = {};
+  for (const r of share.SHARED_RESOURCES) resources[r] = share.resourceState(dir, r);
+  const sharedCount = Object.values(resources).filter((st) => st === 'shared').length;
+  const { credentialSource, loggedIn, email } = profiles.readProfile(dir);
   const displayEmail = reveal ? email : (email ? envLib.maskEmail(email) : email);
 
   let config = null;
@@ -537,8 +624,10 @@ function cmdListOne(name, { json, reveal }) {
       name,
       dir,
       loggedIn,
+      credentialSource,
       email: displayEmail,
       shared: sharedCount,
+      resources,
       endpoint: envLib.endpointSummary(dir),
     };
     if (config) {
@@ -558,9 +647,18 @@ function cmdListOne(name, { json, reveal }) {
 
   console.log(`Profile:   ${name}`);
   console.log(`Directory: ${dir}`);
-  console.log(`LoggedIn:  ${loggedIn ? 'true' : 'false'}`);
+  console.log(
+    `LoggedIn:  ${loggedIn ? 'true' : 'false'}` +
+      (credentialSource === 'keychain' ? ' (macOS Keychain)' : ''),
+  );
   console.log(`Email:     ${displayEmail || '-'}`);
   console.log(`Shared:    ${sharedCount}/${total}`);
+  const width = Math.max(...share.SHARED_RESOURCES.map((r) => resourceLabel(r).length));
+  for (const r of share.SHARED_RESOURCES) {
+    const st = resources[r];
+    const note = st === 'shared' ? `→ ~/.claude/${r}` : (RESOURCE_STATE_NOTES[st] || '');
+    console.log(`  ${resourceLabel(r).padEnd(width)}  ${st.padEnd(12)} ${note}`.trimEnd());
+  }
 
   if (configError) {
     console.log('Endpoint:  (invalid config — .cc-env.json is malformed)');
@@ -620,6 +718,7 @@ function cmdList(rest) {
       name: p.name,
       dir: p.dir,
       loggedIn: p.loggedIn,
+      credentialSource: p.credentialSource,
       email: reveal ? p.email : (p.email ? envLib.maskEmail(p.email) : p.email),
       shared: sharedCount,
       endpoint: envLib.endpointSummary(p.dir),
@@ -633,7 +732,7 @@ function cmdList(rest) {
 
   if (enriched.length === 0) {
     console.log(`No profiles yet in ${profiles.baseDir()}.`);
-    console.log('Create one with:  cc add <name>');
+    console.log('Create one with:  cchost add <name>');
     return 0;
   }
 
@@ -674,7 +773,7 @@ function hasPrivateContent(dir) {
 async function cmdRemove(rest) {
   const { flags, positional } = parseFlagsStrict(rest, ['--force'], { allowPositional: true });
   const [name, ...extra] = positional;
-  if (!name) throw usageError('Usage: cc remove <profile> [--force]');
+  if (!name) throw usageError('Usage: cchost remove <profile> [--force]');
   if (extra.length > 0) throw usageError(`Unexpected argument: ${extra[0]}`);
   const force = flags.has('--force');
   profiles.validateProfileName(name);
@@ -689,7 +788,7 @@ async function cmdRemove(rest) {
     const err = new Error(
       `Profile "${name}" has private (unlinked) resources whose content is not ` +
         `in ~/.claude/. Removing the profile will delete that content permanently.\n` +
-        `Re-run with --force to confirm: cc remove ${name} --force`,
+        `Re-run with --force to confirm: cchost remove ${name} --force`,
     );
     err.exitCode = 1;
     throw err;
@@ -721,19 +820,22 @@ async function cmdRemove(rest) {
 async function cmdLink(rest) {
   const { flags, positional } = parseFlagsStrict(
     rest,
-    ['--tools', '--projects', '--config'],
+    ['--tools', '--projects', '--config', '--dry-run'],
     { allowPositional: true },
   );
   if (positional.length === 0) {
     throw usageError(
-      'Usage: cc link <profile> [<profile>...] [--projects|--tools|--config]',
+      'Usage: cchost link <profile> [<profile>...] [--projects|--tools|--config] [--dry-run]',
     );
   }
+  const dryRun = flags.has('--dry-run');
   const opts = {
     tools: flags.has('--tools'),
     projects: flags.has('--projects'),
     config: flags.has('--config'),
+    dryRun,
   };
+  if (dryRun) console.log('Dry run — nothing will be changed.');
   const multi = positional.length > 1;
   const summary = [];
   for (const name of positional) {
@@ -752,19 +854,27 @@ async function cmdLink(rest) {
         process.stderr.write(color.stderr.red(`  ${label}: failed — ${r.message}`) + '\n');
       } else if (r.status === 'refused') {
         process.stderr.write(color.stderr.yellow(`  ${label}: refused — ${r.message}`) + '\n');
+      } else if (r.status === 'foreign-link') {
+        process.stderr.write(color.stderr.yellow(`  ${label}: foreign link — ${r.message}`) + '\n');
       } else if (r.status === 'already-linked') {
         console.log(`  ${label}: already linked`);
       } else if (r.relinkedFromLegacy) {
-        console.log(`  ${label}: relinked (was pointing at legacy ~/.claude-shared/)`);
+        console.log(
+          `  ${label}: ${dryRun ? 'would relink' : 'relinked'} (was pointing at legacy ~/.claude-shared/)`,
+        );
+      } else if (dryRun) {
+        console.log(`  ${label}: would link → ~/.claude/${r.resource}`);
       } else {
         const note = r.kind === 'hardlink' ? ' (hard link — enable Windows Developer Mode for a true symlink)' : '';
         console.log(`  ${label}: linked${note}`);
       }
     }
-    const failed = results.filter((r) => r.status === 'failed' || r.status === 'refused');
+    const failed = results.filter(
+      (r) => r.status === 'failed' || r.status === 'refused' || r.status === 'foreign-link',
+    );
     const linked = results.length - failed.length;
     console.log(
-      `  ${linked}/${results.length} linked` +
+      `  ${dryRun ? 'would end with ' : ''}${linked}/${results.length} linked` +
         (failed.length ? `, ${failed.length} not linked` : '') + '.',
     );
     summary.push({
@@ -794,19 +904,22 @@ async function cmdLink(rest) {
 async function cmdUnlink(rest) {
   const { flags, positional } = parseFlagsStrict(
     rest,
-    ['--tools', '--projects', '--config'],
+    ['--tools', '--projects', '--config', '--dry-run'],
     { allowPositional: true },
   );
   const [name, ...extra] = positional;
   if (!name) {
-    throw usageError('Usage: cc unlink <profile> [--projects|--tools|--config]');
+    throw usageError('Usage: cchost unlink <profile> [--projects|--tools|--config] [--dry-run]');
   }
   if (extra.length > 0) throw usageError(`Unexpected argument: ${extra[0]}`);
+  const dryRun = flags.has('--dry-run');
   const opts = {
     tools: flags.has('--tools'),
     projects: flags.has('--projects'),
     config: flags.has('--config'),
+    dryRun,
   };
+  if (dryRun) console.log('Dry run — nothing will be changed.');
   const results = share.shareUnlink(name, opts);
   let anyFailure = false;
   for (const r of results) {
@@ -816,6 +929,9 @@ async function cmdUnlink(rest) {
       process.stderr.write(color.stderr.red(`  ${label}: failed — ${r.message}`) + '\n');
     } else if (r.status === 'not-linked') {
       console.log(`  ${label}: not linked, skipping`);
+    } else if (dryRun) {
+      const what = r.items === undefined ? 'its content' : `${r.items} item(s)`;
+      console.log(`  ${label}: would unlink and copy ${what} from ~/.claude/ into the profile`);
     } else {
       console.log(`  ${label}: unlinked, content copied back`);
     }
@@ -834,24 +950,30 @@ async function cmdDoctor(rest) {
 }
 
 async function cmdCopy(rest) {
-  const { flags, positional } = parseFlagsStrict(rest, ['--force'], { allowPositional: true });
+  const { flags, positional } = parseFlagsStrict(
+    rest,
+    ['--force', '--dry-run'],
+    { allowPositional: true },
+  );
   const [src, dest, ...extra] = positional;
-  if (!src || !dest) throw usageError('Usage: cc copy <src> <dest> [--force]');
+  if (!src || !dest) throw usageError('Usage: cchost copy <src> <dest> [--force] [--dry-run]');
   if (extra.length > 0) throw usageError(`Unexpected extra arguments: ${extra.join(' ')}`);
   const force = flags.has('--force');
+  const dryRun = flags.has('--dry-run');
+  if (dryRun) process.stdout.write('Dry run — nothing will be changed.\n');
   if (force) {
     process.stdout.write(
-      'Warning: --force is set. Existing items at the destination will be overwritten.\n',
+      `Warning: --force is set. Existing items at the destination ${dryRun ? 'would' : 'will'} be overwritten.\n`,
     );
   }
-  copyLib.copy(src, dest, { force });
+  copyLib.copy(src, dest, { force, dryRun });
   return 0;
 }
 
 async function cmdMigrate(rest) {
   process.stderr.write(
     color.stderr.yellow(
-      "[cchost] 'cc migrate' is deprecated — use 'cc copy' instead. " +
+      "[cchost] 'cchost migrate' is deprecated — use 'cchost copy' instead. " +
         'This alias will be removed in a future version.',
     ) + '\n',
   );
@@ -876,8 +998,8 @@ async function run(argv) {
   if (action === 'env') {
     process.stderr.write(
       color.stderr.red(
-        "'cc env' was removed in v0.3.1. Configure a custom endpoint with " +
-          "'cc add <profile> --custom', and view it with 'cc list <profile>'.",
+        "'cchost env' was removed in v0.3.1. Configure a custom endpoint with " +
+          "'cchost add <profile> --custom', and view it with 'cchost list <profile>'.",
       ) + '\n',
     );
     return 2;