setup-cc-room 0.2.0 → 0.2.2

package/dist/chunk-SMSDMP5O.js

@@ -0,0 +1,125 @@
+import {
+  resolveDaemonSource
+} from "./chunk-KEFBOTQD.js";
+import {
+  registerService
+} from "./chunk-ZDOKJ4KX.js";
+import {
+  resolveCcRoomDir
+} from "./chunk-WCEABGOA.js";
+import {
+  mergeSettings
+} from "./chunk-MVD6RIS2.js";
+import {
+  t
+} from "./chunk-OYW7MM4W.js";
+
+// src/installer.ts
+import {
+  mkdirSync,
+  writeFileSync,
+  existsSync,
+  copyFileSync,
+  chmodSync,
+  unlinkSync
+} from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+import { execFileSync, spawnSync } from "child_process";
+import { fileURLToPath } from "url";
+import { stringify } from "yaml";
+var CC_ROOM_DIR = resolveCcRoomDir();
+var BIN_DIR = join(CC_ROOM_DIR, "bin");
+var CONFIG_PATH = join(CC_ROOM_DIR, "config.yaml");
+var COMMANDS_DIR = join(homedir(), ".claude", "commands");
+var THIS_DIR = dirname(fileURLToPath(import.meta.url));
+var SETUP_PACKAGE_ROOT = join(THIS_DIR, "..");
+function getGitUserName() {
+  try {
+    return execFileSync("git", ["config", "user.name"], { encoding: "utf-8", stdio: "pipe" }).trim();
+  } catch {
+    return "unknown";
+  }
+}
+function resolveCommandSources(setupPackageRoot, locale) {
+  const candidates = [
+    join(setupPackageRoot, "vendor", "commands", "room", locale),
+    join(setupPackageRoot, "..", "commands", "room", locale),
+    // legacy flat layout (pre-i18n)
+    join(setupPackageRoot, "vendor", "commands", "room"),
+    join(setupPackageRoot, "..", "commands", "room")
+  ];
+  for (const dir of candidates) {
+    if (existsSync(join(dir, "room.md"))) return dir;
+  }
+  return null;
+}
+async function install(locale = "en") {
+  console.log(t("install.step1", { dir: CC_ROOM_DIR }));
+  mkdirSync(BIN_DIR, { recursive: true });
+  const daemonSrc = resolveDaemonSource(SETUP_PACKAGE_ROOT);
+  const daemonDest = join(BIN_DIR, "cc-room-daemon");
+  if (daemonSrc) {
+    copyFileSync(daemonSrc, daemonDest);
+    chmodSync(daemonDest, 493);
+    console.log(t("install.copied", { path: daemonDest }));
+  } else {
+    const globalBin = spawnSync("which", ["cc-room-daemon"], { encoding: "utf-8" });
+    if (globalBin.status === 0) {
+      console.log(t("install.global_ok", { path: globalBin.stdout.trim() }));
+    } else {
+      console.log(`  \x1B[33m\u26A0 ${t("daemon.missing")}\x1B[0m`);
+    }
+  }
+  console.log(t("install.step2", { path: CONFIG_PATH }));
+  if (!existsSync(CONFIG_PATH)) {
+    const identity = getGitUserName();
+    const config = {
+      identity: { name: identity },
+      ui: { locale },
+      network: { port: 7331, http_port: 7332 },
+      trust: [],
+      sessions: { default_mode: "approve", share_files: true, share_context: true },
+      privacy: {
+        public_tools: ["room_context", "room_messages", "room_files", "room_status", "room_invite", "room_share"],
+        private_patterns: [],
+        redact_after_private_tool: true
+      },
+      summarizer: { model: "claude-haiku-4-5-20251001", interval_turns: 5, interval_seconds: 30 },
+      storage: { max_bytes: 524288e3, artifact_ttl_days: 30, context_ttl_days: 7, message_ttl_days: 14 }
+    };
+    writeFileSync(CONFIG_PATH, stringify(config), { mode: 384 });
+    console.log(t("install.config_created", { path: CONFIG_PATH, identity }));
+  } else {
+    console.log(t("install.config_skip", { path: CONFIG_PATH }));
+  }
+  console.log(t("install.step3", { locale }));
+  mkdirSync(COMMANDS_DIR, { recursive: true });
+  const commandFiles = ["room.md", "private.md", "show.md"];
+  const legacyFiles = ["invite.md", "join.md", "leave.md", "files.md", "remember.md", "share.md"];
+  const commandsSrcDir = resolveCommandSources(SETUP_PACKAGE_ROOT, locale);
+  if (!commandsSrcDir) {
+    throw new Error(`Command source directory not found for locale=${locale}`);
+  }
+  for (const cmd of commandFiles) {
+    const src = join(commandsSrcDir, cmd);
+    if (!existsSync(src)) throw new Error(`Command source file not found: ${src}`);
+    copyFileSync(src, join(COMMANDS_DIR, cmd));
+  }
+  for (const legacy of legacyFiles) {
+    const dest = join(COMMANDS_DIR, legacy);
+    if (existsSync(dest)) {
+      unlinkSync(dest);
+    }
+  }
+  console.log(t("install.commands_ok", { count: commandFiles.length, dir: COMMANDS_DIR }));
+  console.log(t("install.step4"));
+  mergeSettings();
+  console.log(t("install.step5"));
+  await registerService();
+}
+
+export {
+  resolveCommandSources,
+  install
+};

package/dist/chunk-ZDOKJ4KX.js

@@ -0,0 +1,132 @@
+import {
+  resolveCcRoomDir
+} from "./chunk-WCEABGOA.js";
+import {
+  t
+} from "./chunk-OYW7MM4W.js";
+
+// src/register-service.ts
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir, platform } from "os";
+import { execFileSync } from "child_process";
+var CC_ROOM_DIR = resolveCcRoomDir();
+function getDaemonBinPath() {
+  try {
+    const which = execFileSync("which", ["cc-room-daemon"], { encoding: "utf-8", stdio: "pipe" }).trim();
+    if (which) return which;
+  } catch {
+  }
+  return join(CC_ROOM_DIR, "bin", "cc-room-daemon");
+}
+function ccRoomHomeEnvXml() {
+  if (!process.env.CC_ROOM_HOME) return "";
+  return `
+    <key>CC_ROOM_HOME</key>
+    <string>${process.env.CC_ROOM_HOME}</string>`;
+}
+function registerLaunchd() {
+  const plistDir = join(homedir(), "Library", "LaunchAgents");
+  const plistPath = join(plistDir, "dev.ccroom.daemon.plist");
+  const daemonBin = getDaemonBinPath();
+  const logPath = join(CC_ROOM_DIR, "logs", "daemon.log");
+  mkdirSync(join(CC_ROOM_DIR, "logs"), { recursive: true });
+  mkdirSync(plistDir, { recursive: true });
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>dev.ccroom.daemon</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${daemonBin}</string>
+  </array>
+  <key>KeepAlive</key>
+  <true/>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${logPath}</string>
+  <key>StandardErrorPath</key>
+  <string>${logPath}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin</string>${ccRoomHomeEnvXml()}
+  </dict>
+</dict>
+</plist>
+`;
+  writeFileSync(plistPath, plist, { mode: 420 });
+  try {
+    execFileSync("launchctl", ["unload", plistPath], { stdio: "pipe" });
+  } catch {
+  }
+  try {
+    execFileSync("launchctl", ["load", plistPath], { stdio: "pipe" });
+    console.log(t("svc.launchd_ok", { path: plistPath }));
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.log(t("svc.launchd_fail", { msg }));
+    console.log(t("svc.launchd_manual", { path: plistPath }));
+  }
+}
+function registerSystemd() {
+  const serviceDir = join(homedir(), ".config", "systemd", "user");
+  const servicePath = join(serviceDir, "cc-room-daemon.service");
+  const daemonBin = getDaemonBinPath();
+  const logPath = join(CC_ROOM_DIR, "logs", "daemon.log");
+  mkdirSync(join(CC_ROOM_DIR, "logs"), { recursive: true });
+  mkdirSync(serviceDir, { recursive: true });
+  const envLine = process.env.CC_ROOM_HOME ? `Environment=CC_ROOM_HOME=${process.env.CC_ROOM_HOME}
+` : "";
+  const unit = `[Unit]
+Description=cc-room daemon
+After=network.target
+
+[Service]
+ExecStart=${daemonBin}
+Restart=on-failure
+RestartSec=5
+${envLine}StandardOutput=append:${logPath}
+StandardError=append:${logPath}
+
+[Install]
+WantedBy=default.target
+`;
+  writeFileSync(servicePath, unit, { mode: 420 });
+  try {
+    execFileSync("systemctl", ["--user", "daemon-reload"], { stdio: "pipe" });
+    execFileSync("systemctl", ["--user", "enable", "--now", "cc-room-daemon"], { stdio: "pipe" });
+    console.log(t("svc.systemd_ok", { path: servicePath }));
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.log(t("svc.systemd_fail", { msg }));
+    console.log(t("svc.systemd_manual"));
+  }
+}
+async function registerService() {
+  const os = platform();
+  if (os === "darwin") {
+    registerLaunchd();
+  } else if (os === "linux") {
+    registerSystemd();
+  } else {
+    console.log(t("svc.unsupported", { os }));
+  }
+  const pidPath = join(CC_ROOM_DIR, "daemon.pid");
+  if (!existsSync(pidPath)) {
+    console.log(t("svc.waiting"));
+    await new Promise((resolve) => setTimeout(resolve, 2e3));
+  }
+  if (existsSync(pidPath)) {
+    console.log(t("svc.started"));
+  } else {
+    console.log(t("svc.start_unconfirmed"));
+  }
+}
+
+export {
+  registerService
+};

package/dist/daemon-resolver.d.ts

@@ -3,6 +3,6 @@
  * 優先: vendor 同梱（npm / pack:vendor）→ ローカル dist-bundle
  */
 declare function resolveDaemonSource(setupPackageRoot: string): string | null;
-declare const DAEMON_MISSING_HINT = "cc-room-daemon \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u30EA\u30DD\u30B8\u30C8\u30EA\u3067\u306F `pnpm --filter setup-cc-room run pack:vendor` \u3092\u5B9F\u884C\u3059\u308B\u304B\u3001npm \u306E setup-cc-room \u30D1\u30C3\u30B1\u30FC\u30B8\u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002";
+declare const DAEMON_MISSING_HINT = "cc-room-daemon not found. In the repo run `pnpm --filter setup-cc-room run pack:vendor`, or use the npm setup-cc-room package.";
 
 export { DAEMON_MISSING_HINT, resolveDaemonSource };

package/dist/daemon-resolver.js

@@ -1,7 +1,7 @@
 import {
   DAEMON_MISSING_HINT,
   resolveDaemonSource
-} from "./chunk-R5BAC4BK.js";
+} from "./chunk-KEFBOTQD.js";
 export {
   DAEMON_MISSING_HINT,
   resolveDaemonSource

package/dist/i18n.d.ts

@@ -0,0 +1,7 @@
+type Locale = "en" | "ja";
+declare function resolveLocale(argv?: string[], env?: NodeJS.ProcessEnv): Locale;
+declare function setLocale(locale: Locale): void;
+declare function getLocale(): Locale;
+declare function t(key: string, vars?: Record<string, string | number>): string;
+
+export { type Locale, getLocale, resolveLocale, setLocale, t };

package/dist/i18n.js

@@ -0,0 +1,12 @@
+import {
+  getLocale,
+  resolveLocale,
+  setLocale,
+  t
+} from "./chunk-OYW7MM4W.js";
+export {
+  getLocale,
+  resolveLocale,
+  setLocale,
+  t
+};

package/dist/index.js

@@ -1,57 +1,92 @@
 #!/usr/bin/env node
+import {
+  printResults,
+  validateAll
+} from "./chunk-RYVZHEHF.js";
 import {
   install
-} from "./chunk-QOXK3LB2.js";
-import "./chunk-R5BAC4BK.js";
-import "./chunk-UWFC4FU6.js";
+} from "./chunk-SMSDMP5O.js";
+import "./chunk-KEFBOTQD.js";
+import "./chunk-ZDOKJ4KX.js";
+import {
+  uninstall
+} from "./chunk-MSQUTURC.js";
 import "./chunk-WCEABGOA.js";
-import "./chunk-5NTML4PF.js";
+import "./chunk-MVD6RIS2.js";
 import {
-  printResults,
-  validateAll
-} from "./chunk-NJES6PZ3.js";
+  getLocale,
+  resolveLocale,
+  setLocale,
+  t
+} from "./chunk-OYW7MM4W.js";
 
 // src/index.ts
-async function main() {
-  console.log("\n  \u{1F3E0} setup-cc-room v0.2.0\n");
-  console.log("  Preflight checks \u3092\u5B9F\u884C\u4E2D...");
+var VERSION = "0.2.2";
+function stripLangArgs(argv) {
+  const out = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--lang" || a === "--locale") {
+      i++;
+      continue;
+    }
+    if (a.startsWith("--lang=") || a.startsWith("--locale=")) continue;
+    out.push(a);
+  }
+  return out;
+}
+function printHelp() {
+  console.log(t("cli.help", { version: VERSION }));
+}
+async function runInstall() {
+  console.log(`
+  \u{1F3E0} setup-cc-room v${VERSION}
+`);
+  console.log(t("cli.running_preflight"));
   const { passed, results } = validateAll();
   printResults(results);
   if (!passed) {
-    console.log("  \x1B[31m\u524D\u63D0\u6761\u4EF6\u3092\u6E80\u305F\u3057\u3066\u3044\u307E\u305B\u3093\u3002\u4E0A\u8A18\u306E\u554F\u984C\u3092\u89E3\u6C7A\u3057\u3066\u304B\u3089\u518D\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002\x1B[0m\n");
+    console.log(t("cli.preflight_failed"));
     process.exit(1);
   }
-  console.log("  \x1B[32m\u5168\u30C1\u30A7\u30C3\u30AF\u901A\u904E\u3002\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u3092\u958B\u59CB\u3057\u307E\u3059\u3002\x1B[0m\n");
-  await install();
+  console.log(t("cli.preflight_ok"));
+  await install(getLocale());
   console.log(`
-  \x1B[32m\u2705 \u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u304C\u5B8C\u4E86\u3057\u307E\u3057\u305F\uFF01\x1B[0m
-
-  cc-room \u306E\u4F7F\u3044\u65B9:
-
-  \u3010\u4F1A\u8B70\u5BA4\u3092\u958B\u304F\u5834\u5408\u3011
-    1. Claude Code \u3092\u518D\u8D77\u52D5\uFF08MCP \u3068 Hooks \u3092\u6709\u52B9\u5316\uFF09
-    2. /room open <name>  \u2190 \u4F1A\u8B70\u5BA4\u3092\u958B\u304F\uFF08PIN \u767A\u884C\uFF09
-    3. \u8868\u793A\u3055\u308C\u308B\u90E8\u5C4B\u540D\u3068 PIN \u3092\u76F8\u624B\u306B\u53E3\u982D\u3084 DM \u3067\u4F1D\u3048\u308B
-    4. \u76F8\u624B\u304C /room join <name> <PIN> \u3092\u5B9F\u884C\u3059\u308C\u3070\u53C2\u52A0\u5B8C\u4E86
-
-  \u3010\u62DB\u5F85\u3055\u308C\u305F\u5834\u5408\u3011
-    1. Claude Code \u3092\u518D\u8D77\u52D5
-    2. /room join <name> <PIN>  \u2190 \u76F8\u624B\u304B\u3089\u53D7\u3051\u53D6\u3063\u305F\u5024\u3092\u5165\u529B
-
-  \u3010\u65E5\u5E38\u64CD\u4F5C\u3011
-    /room             \u2026 \u30DB\u30EF\u30A4\u30C8\u30DC\u30FC\u30C9\u3092\u898B\u308B
-    /private          \u2026 \u72B6\u614B\u8868\u793A\u3001\u624B\u5143/\u516C\u958B\u306E\u5207\u66FF\uFF08on|off|share|drop\uFF09
-
-  \u26A0\uFE0F  cc-room \u306F\u81EA\u52D5\u3067\u76F8\u624B\u306B\u901A\u77E5\u3057\u307E\u305B\u3093\u3002
-      \u90E8\u5C4B\u540D\u3068 PIN \u306F\u81EA\u5206\u3067\u76F8\u624B\u306B\u4F1D\u3048\u3066\u304F\u3060\u3055\u3044\u3002
-
-  \u63A5\u7D9A\u5F8C\u306F\u540C\u3058 WiFi\uFF08LAN\uFF09\u5185\u306B\u3044\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\u3002
-  \uFF08VPN \u3067\u540C\u4E00 LAN \u76F8\u5F53\u306B\u306A\u308C\u3070\u30EA\u30E2\u30FC\u30C8\u3067\u3082\u4F7F\u3048\u307E\u3059\uFF09
+${t("cli.install_done")}
+${t("cli.install_guide")}
+`);
+}
+async function runUninstall() {
+  console.log(`
+  \u{1F3E0} setup-cc-room v${VERSION} \u2014 uninstall
+`);
+  await uninstall();
+  console.log(`
+${t("cli.uninstall_done")}
 
-  \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8: https://github.com/takanorisuzuki/cc-room
+${t("cli.restart_claude")}
 `);
 }
+async function main() {
+  setLocale(resolveLocale(process.argv, process.env));
+  const args = stripLangArgs(process.argv.slice(2));
+  const arg = args[0];
+  if (arg === "--help" || arg === "-h" || arg === "help") {
+    printHelp();
+    return;
+  }
+  if (arg === "uninstall" || arg === "--uninstall") {
+    await runUninstall();
+    return;
+  }
+  if (arg && arg !== "install") {
+    console.error(t("cli.unknown_arg", { arg }));
+    printHelp();
+    process.exit(1);
+  }
+  await runInstall();
+}
 main().catch((err) => {
-  console.error("  \x1B[31m\u30A8\u30E9\u30FC:\x1B[0m", err instanceof Error ? err.message : err);
+  console.error(t("cli.error"), err instanceof Error ? err.message : err);
   process.exit(1);
 });

package/dist/installer.d.ts

@@ -1,3 +1,6 @@
-declare function install(): Promise<void>;
+import { Locale } from './i18n.js';
 
-export { install };
+declare function resolveCommandSources(setupPackageRoot: string, locale: Locale): string | null;
+declare function install(locale?: Locale): Promise<void>;
+
+export { install, resolveCommandSources };

package/dist/installer.js

@@ -1,10 +1,13 @@
 import {
-  install
-} from "./chunk-QOXK3LB2.js";
-import "./chunk-R5BAC4BK.js";
-import "./chunk-UWFC4FU6.js";
+  install,
+  resolveCommandSources
+} from "./chunk-SMSDMP5O.js";
+import "./chunk-KEFBOTQD.js";
+import "./chunk-ZDOKJ4KX.js";
 import "./chunk-WCEABGOA.js";
-import "./chunk-5NTML4PF.js";
+import "./chunk-MVD6RIS2.js";
+import "./chunk-OYW7MM4W.js";
 export {
-  install
+  install,
+  resolveCommandSources
 };

package/dist/register-service.js

@@ -1,7 +1,8 @@
 import {
   registerService
-} from "./chunk-UWFC4FU6.js";
+} from "./chunk-ZDOKJ4KX.js";
 import "./chunk-WCEABGOA.js";
+import "./chunk-OYW7MM4W.js";
 export {
   registerService
 };

package/dist/settings-merger.d.ts

@@ -1,3 +1,6 @@
 declare function mergeSettings(): void;
+/** settings.json から cc-room の hooks / mcpServers を除去（他設定は保持） */
+declare function stripCcRoomFromSettings(settings: Record<string, unknown>): Record<string, unknown>;
+declare function unmergeSettings(): void;
 
-export { mergeSettings };
+export { mergeSettings, stripCcRoomFromSettings, unmergeSettings };

package/dist/settings-merger.js

@@ -1,6 +1,11 @@
 import {
-  mergeSettings
-} from "./chunk-5NTML4PF.js";
+  mergeSettings,
+  stripCcRoomFromSettings,
+  unmergeSettings
+} from "./chunk-MVD6RIS2.js";
+import "./chunk-OYW7MM4W.js";
 export {
-  mergeSettings
+  mergeSettings,
+  stripCcRoomFromSettings,
+  unmergeSettings
 };

package/dist/uninstaller.d.ts

@@ -0,0 +1,10 @@
+declare function getLaunchdPlistPath(home?: string): string;
+declare function getSystemdUnitPath(home?: string): string;
+declare function stopLaunchd(plistPath: string): void;
+declare function stopSystemd(unitPath: string): void;
+declare function removeCommandFiles(commandsDir: string): void;
+declare function removeCcRoomData(ccRoomDir: string): void;
+declare function stopOrphanDaemon(): void;
+declare function uninstall(): Promise<void>;
+
+export { getLaunchdPlistPath, getSystemdUnitPath, removeCcRoomData, removeCommandFiles, stopLaunchd, stopOrphanDaemon, stopSystemd, uninstall };

package/dist/uninstaller.js

@@ -0,0 +1,23 @@
+import {
+  getLaunchdPlistPath,
+  getSystemdUnitPath,
+  removeCcRoomData,
+  removeCommandFiles,
+  stopLaunchd,
+  stopOrphanDaemon,
+  stopSystemd,
+  uninstall
+} from "./chunk-MSQUTURC.js";
+import "./chunk-WCEABGOA.js";
+import "./chunk-MVD6RIS2.js";
+import "./chunk-OYW7MM4W.js";
+export {
+  getLaunchdPlistPath,
+  getSystemdUnitPath,
+  removeCcRoomData,
+  removeCommandFiles,
+  stopLaunchd,
+  stopOrphanDaemon,
+  stopSystemd,
+  uninstall
+};

package/dist/validators.js

@@ -1,7 +1,8 @@
 import {
   printResults,
   validateAll
-} from "./chunk-NJES6PZ3.js";
+} from "./chunk-RYVZHEHF.js";
+import "./chunk-OYW7MM4W.js";
 export {
   printResults,
   validateAll

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "setup-cc-room",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Install cc-room — bring your Claude Code into a shared LAN meeting room",
   "license": "MIT",
   "author": "Takanori Suzuki",
@@ -18,7 +18,7 @@
     "vendor"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/installer.ts src/settings-merger.ts src/register-service.ts src/validators.ts src/daemon-resolver.ts src/paths.ts --format esm --dts",
+    "build": "tsup src/index.ts src/installer.ts src/settings-merger.ts src/register-service.ts src/validators.ts src/daemon-resolver.ts src/paths.ts src/uninstaller.ts src/i18n.ts --format esm --dts",
     "dev": "tsup src/index.ts --format esm --watch",
     "pack:vendor": "node scripts/pack-vendor.mjs",
     "prepack": "pnpm run build && pnpm run pack:vendor",

package/vendor/commands/room/en/private.md

@@ -0,0 +1,75 @@
+---
+name: private
+description: Toggle local (Private) mode. When turning off, always choose share or drop for pending work.
+---
+
+Toggle between local (Private) and public. While public (Private OFF), summaries and artifacts flow to the Primary room automatically. Work done during Private ON accumulates as pending and stays invisible to others.
+
+## Resolve the port
+
+Before every HTTP request, resolve the port:
+
+```bash
+CC_ROOM_HOME="${CC_ROOM_HOME:-$HOME/.cc-room}"
+HTTP_PORT=$(grep 'http_port:' "$CC_ROOM_HOME/config.yaml" 2>/dev/null | awk '{print $2}' | tr -d '[:space:]')
+HTTP_PORT="${HTTP_PORT:-7332}"
+BASE_URL="http://127.0.0.1:$HTTP_PORT"
+```
+
+## Subcommands
+
+### `/private` (no args) — status
+
+1. `GET $BASE_URL/status`.
+2. Display:
+   ```
+   🔒 Private ON (local mode) / 📡 Live (Private OFF)
+   Primary: <primary_room_name>
+   Pending local work: <pending_turns + pending_files> items
+   ```
+
+### `/private on` — enter local mode
+
+1. `POST $BASE_URL/private` with `{ "mode": "on" }`.
+2. On success:
+   ```
+   🔒 Switched to local mode. Your work is hidden (use /private off to go public)
+   ```
+
+### `/private off` — return to public
+
+1. `POST $BASE_URL/private` with `{ "mode": "off" }`.
+2. Branch on the response:
+   - If `needs_choice: true`, **always ask the user** (never auto-share):
+     ```
+     You have <pending> pending items. Send them to Primary (<primary_room_name>)?
+     → share (send, then go public) / drop (discard, then go public)
+     ```
+     Then run `/private share` or `/private drop` based on their choice.
+   - If no `needs_choice` (0 pending):
+     ```
+     📡 Back to public. Work summaries will flow to Primary (<primary_room_name>)
+     ```
+
+### `/private share` — share pending, then go public
+
+1. `POST $BASE_URL/private` with `{ "mode": "share" }`.
+2. On success:
+   ```
+   📡 Shared <shared> pending items to Primary (<primary_room_name>) and returned to public
+   ```
+
+### `/private drop` — discard pending, then go public
+
+1. `POST $BASE_URL/private` with `{ "mode": "drop" }`.
+2. On success:
+   ```
+   🗑 Discarded <dropped> pending items and returned to public
+   ```
+
+## Errors
+
+- If the daemon is not running:
+  "cc-room daemon is not running."
+- If not in a room:
+  "You are not in a room. Use `/room open` or `/room join` first."