cc-hub-cli 1.1.5 → 1.1.7

package/README.md

@@ -159,6 +159,44 @@ Invoke-Expression (& cc-hub completion powershell | Out-String)
 
 Completes subcommands, profile names, and event types.
 
+## Logging
+
+cc-hub writes structured logs to `~/.claude/cc-hub/logs/cc-hub-YYYY-MM-DD.log`.
+
+### Log levels
+
+Levels are ordered from most to least verbose:
+
+| Level | Description |
+|---|---|
+| `DEBUG` | All service calls, file reads/writes, path encode/decode, proxy requests |
+| `INFO`  | Command executions, profile launches, proxy start/stop |
+| `WARN`  | JSON auto-fix events, backup restores |
+| `ERROR` | Thrown exceptions, upstream errors, uncaught exceptions/rejections |
+
+The default level is `INFO`. To change it, add `_cc_hub_logLevel` to `~/.claude/settings.json`:
+
+```json
+{
+  "_cc_hub_logLevel": "DEBUG"
+}
+```
+
+Valid values: `DEBUG`, `INFO`, `WARN`, `ERROR`.
+
+### Viewing logs
+
+```bash
+# Tail today's log
+tail -f ~/.claude/cc-hub/logs/cc-hub-$(date +%Y-%m-%d).log
+
+# View all logs
+ls -lt ~/.claude/cc-hub/logs/
+
+# Search for errors
+grep ERROR ~/.claude/cc-hub/logs/*.log
+```
+
 ## Configuration
 
 cc-hub reads from these paths (overridable via environment variables):

package/dist/index.js

@@ -254,6 +254,14 @@ var NoOpDesktopApp = class {
 import fs3 from "fs";
 import path3 from "path";
 import { randomUUID } from "crypto";
+var ANTHROPIC_ALIASES = ["claude-sonnet-4-5", "claude-opus-4-7", "claude-haiku-4-5-20251001"];
+function isAnthropicModel(model) {
+  const anthropicAliases = ["opus", "sonnet", "haiku", "best", "default", "opusplan", "opus[1m]", "sonnet[1m]"];
+  const lower = model.toLowerCase();
+  if (anthropicAliases.includes(lower)) return true;
+  if (lower.startsWith("claude-")) return true;
+  return false;
+}
 function toDesktopProfile(p) {
   const models = p.models || (p.model ? [p.model] : []);
   const isAnthropic = p.provider === "anthropic" || !p.provider && !p.url;
@@ -263,13 +271,24 @@ function toDesktopProfile(p) {
       inferenceModels: models.map((m) => ({ name: m, supports1m: true }))
     };
   }
-  return {
+  const mappings = [];
+  const mappedModels = models.map((m, index) => {
+    if (isAnthropicModel(m)) return m;
+    const alias = ANTHROPIC_ALIASES[Math.min(index, ANTHROPIC_ALIASES.length - 1)];
+    mappings.push({ alias, actual: m });
+    return alias;
+  });
+  const result = {
     inferenceProvider: "gateway",
     inferenceGatewayBaseUrl: p.url || void 0,
     inferenceGatewayApiKey: p.token || void 0,
     inferenceGatewayAuthScheme: "bearer",
-    inferenceModels: models.map((m) => ({ name: m, supports1m: true }))
+    inferenceModels: mappedModels.map((m) => ({ name: m, supports1m: true }))
   };
+  if (mappings.length > 0) {
+    result.inferenceModelMappings = mappings;
+  }
+  return result;
 }
 var DesktopProfileSyncer = class {
   constructor(app) {
@@ -471,6 +490,7 @@ function fixJsonFile(filePath, fallback = {}) {
   const raw = fs4.readFileSync(filePath, "utf-8");
   try {
     JSON.parse(raw);
+    fs4.mkdirSync(CLAUDE_DIR, { recursive: true });
     fs4.copyFileSync(filePath, backupPath);
     return;
   } catch {
@@ -500,14 +520,24 @@ function fixJsonFile(filePath, fallback = {}) {
     warn(`Fixed invalid JSON in ${path4.basename(filePath)}.`);
     console.error(`Fixed invalid JSON in ${path4.basename(filePath)}.`);
   } catch {
+    let restored = false;
     if (fs4.existsSync(backupPath)) {
-      fs4.copyFileSync(backupPath, filePath);
-      warn(`Restored ${path4.basename(filePath)} from backup.`);
-      console.error(`Restored ${path4.basename(filePath)} from backup.`);
-    } else {
+      try {
+        const backupRaw = fs4.readFileSync(backupPath, "utf-8");
+        JSON.parse(backupRaw);
+        fs4.copyFileSync(backupPath, filePath);
+        restored = true;
+        warn(`Restored ${path4.basename(filePath)} from backup.`);
+        console.error(`Restored ${path4.basename(filePath)} from backup.`);
+      } catch {
+        error(`Backup ${path4.basename(backupPath)} is also corrupt; using fallback.`);
+        console.error(`Backup ${path4.basename(backupPath)} is also corrupt; using fallback.`);
+      }
+    }
+    if (!restored) {
       writeJson(filePath, fallback);
-      error(`Could not fix ${path4.basename(filePath)}, no backup found, reset to default.`);
-      console.error(`Could not fix ${path4.basename(filePath)}, no backup found, reset to default.`);
+      error(`Could not fix ${path4.basename(filePath)}, no valid backup found, reset to default.`);
+      console.error(`Could not fix ${path4.basename(filePath)}, no valid backup found, reset to default.`);
     }
   }
 }
@@ -518,6 +548,9 @@ import { spawnSync as spawnSync2, spawn } from "child_process";
 // src/provider/index.ts
 import { Command } from "commander";
 
+// src/provider/server.ts
+import http from "http";
+
 // src/provider/transform.ts
 function sanitizeToolId(id) {
   let sanitized = id.replace(/[^a-zA-Z0-9_-]/g, "_");
@@ -558,17 +591,26 @@ function transformAnthropicToOpenAI(body) {
         });
       }
       const contentParts = msg.content.filter(
-        (b) => b.type === "text" && b.text || b.type === "image" && b.source
+        (b) => b.type === "text" && b.text || b.type === "image" && (b.source?.type === "base64" && b.source.media_type && b.source.data || b.source?.type === "url" && b.source.url)
       );
       if (contentParts.length > 0) {
         const converted = contentParts.map((part) => {
           if (part.type === "image") {
-            const url = part.source?.type === "base64" ? `data:${part.source.media_type};base64,${part.source.data}` : part.source?.url ?? "";
-            return { type: "image_url", image_url: { url } };
+            if (part.source?.type === "base64" && part.source.media_type && part.source.data) {
+              const url = `data:${part.source.media_type};base64,${part.source.data}`;
+              debug(`transform: converting base64 image (${part.source.media_type}, ${part.source.data.length} chars)`);
+              return { type: "image_url", image_url: { url } };
+            } else if (part.source?.type === "url" && part.source.url) {
+              debug(`transform: converting image url (${part.source.url.slice(0, 80)}...)`);
+              return { type: "image_url", image_url: { url: part.source.url } };
+            }
+            warn(`transform: skipping invalid image block (missing source fields)`);
+            return null;
           }
           return { type: "text", text: part.text };
-        });
-        if (converted.every((p) => p.type === "text")) {
+        }).filter(Boolean);
+        if (converted.length === 0) {
+        } else if (converted.every((p) => p.type === "text")) {
           messages.push({
             role: "user",
             content: converted.map((p) => p.text).join("")
@@ -666,7 +708,7 @@ function transformOpenAIResponseToAnthropic(openaiResponse, originalModel) {
     id: openaiResponse.id ?? `msg_${Date.now()}`,
     type: "message",
     role: "assistant",
-    model: openaiResponse.model ?? originalModel,
+    model: originalModel,
     content,
     stop_reason: finishMap[choice.finish_reason] ?? "end_turn",
     stop_sequence: null,
@@ -734,8 +776,7 @@ data: ${JSON.stringify(data)}
 }
 
 // src/provider/server.ts
-import http from "http";
-async function startOpenAIProxy(targetUrl, apiKey, model, models = []) {
+async function startOpenAIProxy(targetUrl, apiKey, model, models = [], modelMappings = {}) {
   const base = targetUrl.replace(/\/+$/, "");
   const server = http.createServer(async (req, res) => {
     debug(`Proxy request: ${req.method} ${req.url}`);
@@ -761,7 +802,9 @@ async function startOpenAIProxy(targetUrl, apiKey, model, models = []) {
           return;
         }
         const isStream = !!parsed.stream;
-        const openaiBody = transformAnthropicToOpenAI({ ...parsed, stream: false });
+        const requestModel = parsed.model ?? model;
+        const actualModel = modelMappings[requestModel] || requestModel;
+        const openaiBody = transformAnthropicToOpenAI({ ...parsed, model: actualModel, stream: false });
         if (isStream) {
           res.writeHead(200, {
             "Content-Type": "text/event-stream",
@@ -866,6 +909,17 @@ var PROVIDERS = [
     description: "Embedded proxy \u2014 translates Anthropic requests to OpenAI Chat Completions format"
   }
 ];
+var ANTHROPIC_ALIASES2 = ["claude-sonnet-4-5", "claude-opus-4-7", "claude-haiku-4-5-20251001"];
+function isAnthropicModel2(model) {
+  const anthropicAliases = ["opus", "sonnet", "haiku", "best", "default", "opusplan", "opus[1m]", "sonnet[1m]"];
+  const lower = model.toLowerCase();
+  if (anthropicAliases.includes(lower)) return true;
+  if (lower.startsWith("claude-")) return true;
+  return false;
+}
+function collect(value, previous) {
+  return previous.concat([value]);
+}
 function providerCommand() {
   const cmd = new Command("provider").description("Manage provider types");
   cmd.command("list").description("List available provider types").action(safeAction(() => {
@@ -878,8 +932,51 @@ function providerCommand() {
   }));
   return cmd;
 }
+function proxyCommand() {
+  return new Command("proxy").description("Start a standalone OpenAI proxy for the desktop app").option("--profile <name>", "Use configuration from a saved profile").option("-u, --url <url>", "Upstream base URL (e.g., https://api.openai.com)").option("-k, --api-key <key>", "Upstream API key").option("-m, --model <model>", "Default model", "gpt-4o").option("--mapping <mapping>", "Model alias mapping (format: alias:actual, can be used multiple times)", collect, []).action(safeAction(async (opts) => {
+    let targetUrl = opts.url || "https://api.openai.com";
+    let apiKey = opts.apiKey || "";
+    let defaultModel = opts.model || "gpt-4o";
+    let models = [];
+    const modelMappings = {};
+    if (opts.profile) {
+      ensureProfilesFile();
+      const data = readJson(PROFILES_FILE);
+      const p = data.profiles[opts.profile];
+      if (!p) {
+        throw new Error(`Profile '${opts.profile}' not found.`);
+      }
+      targetUrl = p.url || targetUrl;
+      apiKey = p.token || apiKey;
+      models = p.models || (p.model ? [p.model] : []);
+      defaultModel = models[0] || defaultModel;
+      models.forEach((m, i) => {
+        if (!isAnthropicModel2(m)) {
+          const alias = ANTHROPIC_ALIASES2[Math.min(i, ANTHROPIC_ALIASES2.length - 1)];
+          modelMappings[alias] = m;
+        }
+      });
+    } else {
+      for (const m of opts.mapping) {
+        const [alias, actual] = m.split(":");
+        if (alias && actual) {
+          modelMappings[alias] = actual;
+        }
+      }
+      models = [defaultModel];
+    }
+    const { baseUrl, stop } = await startOpenAIProxy(targetUrl, apiKey, defaultModel, models, modelMappings);
+    console.log(`Proxy running at ${baseUrl}`);
+    console.log("Press Ctrl+C to stop");
+    process.on("SIGINT", () => {
+      stop();
+      process.exit(0);
+    });
+  }));
+}
 
 // src/profiles/runner.ts
+var BUILT_IN_DEFAULT = "__builtin__";
 function resolveClaudeBinary() {
   return createBinaryResolver().resolve();
 }
@@ -953,7 +1050,8 @@ function execClaude(profileName, p, extraArgs) {
       p.url || "https://api.openai.com",
       p.token || "",
       firstModel || "gpt-4o",
-      allModels
+      allModels,
+      {}
     ).then(({ baseUrl, stop }) => {
       env.ANTHROPIC_BASE_URL = baseUrl;
       debug(`execClaude: proxy running at ${baseUrl}`);
@@ -976,6 +1074,22 @@ function execClaude(profileName, p, extraArgs) {
     process.exit(result.status ?? 1);
   }
 }
+function execClaudeBuiltIn(extraArgs) {
+  const binary = resolveClaudeBinary();
+  const cmd = [binary, ...extraArgs];
+  const env = {
+    ...process.env,
+    CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: "1",
+    CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1"
+  };
+  info(`Launching Claude with built-in official models: binary=${binary}`);
+  const result = spawnSync2(cmd[0], cmd.slice(1), {
+    stdio: "inherit",
+    env,
+    shell: process.platform === "win32"
+  });
+  process.exit(result.status ?? 1);
+}
 
 // src/profiles/commands.ts
 function maskToken(token) {
@@ -985,10 +1099,10 @@ function maskToken(token) {
 }
 function formatModels(p) {
   if (p.models && p.models.length > 0) {
-    const nonAnthropicModels = p.models.filter((m) => !isAnthropicModel(m));
+    const nonAnthropicModels = p.models.filter((m) => !isAnthropicModel3(m));
     const parts = [];
     p.models.forEach((m, i) => {
-      if (!isAnthropicModel(m)) {
+      if (!isAnthropicModel3(m)) {
         const aliasIndex = nonAnthropicModels.indexOf(m);
         if (aliasIndex === 0) parts.push(`${m} (sonnet)`);
         else if (aliasIndex === 1) parts.push(`${m} (opus)`);
@@ -1006,20 +1120,20 @@ function formatModels(p) {
   }
   return p.model || "(unset)";
 }
-function isAnthropicModel(model) {
+function isAnthropicModel3(model) {
   const anthropicAliases = ["opus", "sonnet", "haiku", "best", "default", "opusplan", "opus[1m]", "sonnet[1m]"];
   const lower = model.toLowerCase();
   if (anthropicAliases.includes(lower)) return true;
   if (lower.startsWith("claude-")) return true;
   return false;
 }
-function collect(value, previous) {
+function collect2(value, previous) {
   return previous.concat([value]);
 }
 function profileCommand() {
   const profile = new Command2("profile").description("Manage Claude CLI profiles");
   const syncer = createProfileSyncer();
-  profile.command("add").description("Add or update a profile").argument("<name>", "Profile name").option("-m, --model <model>", "Model ID - can be used multiple times (max 3)", collect, []).option("-t, --token <token>", "API key / token").option("-u, --url <url>", "Base URL").option("-p, --provider <provider>", "Provider type: anthropic (default) or openai").action(safeAction((name, opts) => {
+  profile.command("add").description("Add or update a profile").argument("<name>", "Profile name").option("-m, --model <model>", "Model ID - can be used multiple times (max 3)", collect2, []).option("-t, --token <token>", "API key / token").option("-u, --url <url>", "Base URL").option("-p, --provider <provider>", "Provider type: anthropic (default) or openai").action(safeAction((name, opts) => {
     const models = opts.model && opts.model.length > 0 ? opts.model : void 0;
     if (models && models.length > 3) {
       throw new Error("Error: A profile can have at most 3 models.");
@@ -1041,7 +1155,7 @@ function profileCommand() {
     debug(`profile add: wrote ${PROFILES_FILE}`);
     console.log(`Profile '${name}' saved.`);
   }));
-  profile.command("update").description("Update fields of an existing profile").argument("<name>", "Profile name (must already exist)").option("-m, --model <model>", "Model ID - can be used multiple times", collect, []).option("-d, --delete-model <model>", "Remove model ID - can be used multiple times", collect, []).option("-t, --token <token>", "API key / token").option("-u, --url <url>", "Base URL").option("-p, --provider <provider>", "Provider type").action(safeAction((name, opts) => {
+  profile.command("update").description("Update fields of an existing profile").argument("<name>", "Profile name (must already exist)").option("-m, --model <model>", "Model ID - can be used multiple times", collect2, []).option("-d, --delete-model <model>", "Remove model ID - can be used multiple times", collect2, []).option("-t, --token <token>", "API key / token").option("-u, --url <url>", "Base URL").option("-p, --provider <provider>", "Provider type").action(safeAction((name, opts) => {
     ensureProfilesFile();
     const data = readJson(PROFILES_FILE);
     if (!data.profiles[name]) {
@@ -1133,6 +1247,9 @@ function profileCommand() {
   profile.command("view").description("View full details of a profile (token unmasked)").argument("<name>", "Profile name").option("-j, --json", "Output as JSON").action(safeAction((name, opts) => {
     ensureProfilesFile();
     const data = readJson(PROFILES_FILE);
+    if (name === BUILT_IN_DEFAULT) {
+      throw new Error(`'${BUILT_IN_DEFAULT}' is not a stored profile. Use 'cc-hub run --built-in' or 'cc-hub use --built-in' for official Anthropic models.`);
+    }
     const p = data.profiles[name];
     if (!p) {
       throw new Error(`Profile '${name}' not found.`);
@@ -1144,10 +1261,10 @@ function profileCommand() {
       console.log(`Name:     ${name}`);
       console.log(`Model:    ${p.model || "(unset)"}`);
       if (p.models && p.models.length > 0) {
-        const nonAnthropicModels = p.models.filter((m) => !isAnthropicModel(m));
+        const nonAnthropicModels = p.models.filter((m) => !isAnthropicModel3(m));
         console.log(`Models:`);
         for (const m of p.models) {
-          if (!isAnthropicModel(m)) {
+          if (!isAnthropicModel3(m)) {
             const aliasIndex = nonAnthropicModels.indexOf(m);
             let alias = "";
             if (aliasIndex === 0) alias = " (sonnet)";
@@ -1194,9 +1311,19 @@ function profileCommand() {
     writeJson(PROFILES_FILE, data);
     console.log(`Profile '${oldName}' renamed to '${newName}'.`);
   }));
-  profile.command("default").description("Set the default profile").argument("<name>", "Profile name to set as default").action(safeAction((name) => {
+  profile.command("default").description("Set the default profile").option("--built-in", "Use official Anthropic models as default").argument("[name]", "Profile name to set as default (required unless --built-in)").action(safeAction((name, opts) => {
     ensureProfilesFile();
     const data = readJson(PROFILES_FILE);
+    if (opts.builtIn) {
+      data.default = BUILT_IN_DEFAULT;
+      writeJson(PROFILES_FILE, data);
+      debug(`profile default: wrote ${PROFILES_FILE}`);
+      console.log("Default set to built-in official Anthropic models.");
+      return;
+    }
+    if (!name) {
+      throw new Error("Profile name is required. Use --built-in for official Anthropic models.");
+    }
     if (!data.profiles[name]) {
       throw new Error(`Profile '${name}' not found.`);
     }
@@ -1219,6 +1346,7 @@ function profileCommand() {
       return;
     }
     for (const name of names) {
+      if (name === BUILT_IN_DEFAULT) continue;
       const p = data.profiles[name];
       debug(`profile sync: syncing '${name}' to desktop`);
       syncer.sync(name, p);
@@ -1231,9 +1359,19 @@ function profileCommand() {
 }
 function useCommand() {
   const syncer = createProfileSyncer();
-  return new Command2("use").description("Set a profile as the default").argument("<name>", "Profile name").action(safeAction((name) => {
+  return new Command2("use").description("Set a profile as the default").option("--built-in", "Use official Anthropic models as default").argument("[name]", "Profile name (required unless --built-in)").action(safeAction((name, opts) => {
     ensureProfilesFile();
     const data = readJson(PROFILES_FILE);
+    if (opts.builtIn) {
+      data.default = BUILT_IN_DEFAULT;
+      writeJson(PROFILES_FILE, data);
+      debug(`use: wrote ${PROFILES_FILE}`);
+      console.log("Default set to built-in official Anthropic models.");
+      return;
+    }
+    if (!name) {
+      throw new Error("Profile name is required. Use --built-in for official Anthropic models.");
+    }
     if (!data.profiles[name]) {
       throw new Error(`Profile '${name}' not found.`);
     }
@@ -1246,10 +1384,14 @@ function useCommand() {
   }));
 }
 function runCommand() {
-  return new Command2("run").description("Launch Claude Code using the default or a specified profile").allowUnknownOption().argument("[args...]", "Optional profile name followed by extra arguments").action(safeAction((args) => {
+  return new Command2("run").description("Launch Claude Code using the default or a specified profile").option("--built-in", "Use official Anthropic models (no custom profile)").allowUnknownOption().argument("[args...]", "Optional profile name followed by extra arguments").action(safeAction((args, opts) => {
     fixJsonFile(CLAUDE_JSON);
     ensureProfilesFile();
     const data = readJson(PROFILES_FILE);
+    if (opts.builtIn) {
+      execClaudeBuiltIn(args);
+      return;
+    }
     let profileName = "";
     let claudeArgs;
     if (args.length > 0 && data.profiles[args[0]]) {
@@ -1259,8 +1401,12 @@ function runCommand() {
       profileName = data.default || "";
       claudeArgs = args;
     }
+    if (profileName === BUILT_IN_DEFAULT) {
+      execClaudeBuiltIn(claudeArgs);
+      return;
+    }
     if (!profileName) {
-      throw new Error("No default profile set. Use 'cc-hub use <name>' first.");
+      throw new Error("No default profile set. Use 'cc-hub use <name>' or 'cc-hub use --built-in' first.");
     }
     const p = data.profiles[profileName];
     debug(`run: launching claude with profile '${profileName}', args=[${claudeArgs.join(", ")}]`);
@@ -1480,7 +1626,7 @@ function encodePath(p) {
   debug(`codec: encode "${p}" -> "${encoded}"`);
   return encoded;
 }
-function decodePath(encoded) {
+function decodePath2(encoded) {
   const decoded = createPathCodec().decode(encoded);
   debug(`codec: decode "${encoded}" -> "${decoded}"`);
   return decoded;
@@ -1596,11 +1742,54 @@ function snippet(text, query, width = 150) {
   const suffix = end < text.length ? "..." : "";
   return prefix + text.slice(start, end) + suffix;
 }
+function findSessionFile(sessionQuery, projectQuery) {
+  debug(`sessions: findSessionFile query="${sessionQuery}" project=${projectQuery || "(any)"}`);
+  let searchDirs = [];
+  if (projectQuery) {
+    const projDir = findProjectDir(projectQuery);
+    if (!projDir) {
+      throw new Error(`No project matched: ${projectQuery}`);
+    }
+    searchDirs.push(path6.join(PROJECTS_DIR, projDir));
+  } else {
+    try {
+      searchDirs = fs6.readdirSync(PROJECTS_DIR).map((d) => path6.join(PROJECTS_DIR, d));
+    } catch {
+      throw new Error(`No projects directory found at ${PROJECTS_DIR}`);
+    }
+  }
+  const matches = [];
+  for (const dir of searchDirs) {
+    let files;
+    try {
+      files = fs6.readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
+    } catch {
+      continue;
+    }
+    for (const file of files) {
+      const sessionId = file.replace(/\.jsonl$/, "");
+      if (sessionId.toLowerCase().includes(sessionQuery.toLowerCase())) {
+        matches.push({ filePath: path6.join(dir, file), project: path6.basename(dir) });
+      }
+    }
+  }
+  if (matches.length === 0) {
+    return null;
+  }
+  if (matches.length > 1) {
+    const lines = matches.map((m) => `  ${path6.basename(m.filePath)} in ${decodePath(m.project)}`).join("\n");
+    throw new Error(`Multiple sessions matched '${sessionQuery}':
+${lines}
+Use --project to disambiguate.`);
+  }
+  return matches[0];
+}
 
 // src/sessions/commands.ts
 import { Command as Command4 } from "commander";
 import fs7 from "fs";
 import path7 from "path";
+import { spawnSync as spawnSync3 } from "child_process";
 function sessionCommand() {
   const session = new Command4("session").description("Manage Claude Code sessions");
   const desktopApp2 = createDesktopApp();
@@ -1630,7 +1819,7 @@ function sessionCommand() {
       } catch {
       }
       const stat = fs7.statSync(fullPath);
-      const decoded = decodePath(projDir);
+      const decoded = decodePath2(projDir);
       if (opts.json) {
         console.log(JSON.stringify({ project: decoded, sessions: nSessions, modified: Math.floor(stat.mtimeMs) }));
       } else if (opts.short) {
@@ -1648,7 +1837,7 @@ function sessionCommand() {
       throw new Error(`No project matched: ${project}`);
     }
     const fullPath = path7.join(PROJECTS_DIR, projDir);
-    console.log(`Project: ${decodePath(projDir)}`);
+    console.log(`Project: ${decodePath2(projDir)}`);
     console.log(`Dir:     ${fullPath}`);
     console.log("");
     const fmt = (sid, name, started, msgs) => `${sid.padEnd(36)}  ${name.padEnd(30)}  ${started.padEnd(17)}  ${msgs}`;
@@ -1742,7 +1931,7 @@ function sessionCommand() {
                   const relPath = path7.relative(baseDir, fullPath);
                   const projEnc = relPath.split(path7.sep)[0];
                   const sessionId = path7.basename(fullPath, ".jsonl");
-                  const projName = label ? projEnc : decodePath(projEnc);
+                  const projName = label ? projEnc : decodePath2(projEnc);
                   console.log(`${label}[${projName}  \u2192  ${sessionId}]`);
                   found = true;
                   count++;
@@ -1928,6 +2117,38 @@ function sessionCommand() {
     const verb = opts.dryRun ? "Would delete" : "Deleted";
     console.log(`${verb} ${deleted} file(s) (~${Math.floor(freed / 1024)}KB freed)`);
   }));
+  session.command("troubleshoot").description("Launch Claude Code to troubleshoot a session file").argument("<session>", "Session ID or partial match").option("-i, --interactive", "Open an interactive Claude Code window instead of a one-shot prompt").action(safeAction((sessionId, opts) => {
+    debug(`session troubleshoot: session=${sessionId} interactive=${!!opts.interactive}`);
+    console.log(`Searching for session '${sessionId}'...`);
+    const match = findSessionFile(sessionId);
+    if (!match) {
+      throw new Error(`Session '${sessionId}' not found.`);
+    }
+    if (!fs7.existsSync(match.filePath)) {
+      throw new Error(`Session file no longer exists: ${match.filePath}`);
+    }
+    console.log(`Found session file: ${match.filePath}`);
+    const nodeBinary = process.argv[0];
+    const scriptPath = process.argv[1];
+    let args;
+    const promptText = `Please analyze this Claude Code session file: ${match.filePath}
+
+The file contains a JSONL conversation history. Review it for any errors, anomalies, or issues (truncated responses, failed tool calls, error messages, corrupted data, etc.). Summarize what happened in the session and identify any problems that need attention. If the file is very large, focus on the most recent turns and any lines containing "error", "exception", "failed", or non-JSON content.`;
+    if (opts.interactive) {
+      console.log("Launching Claude Code (interactive)...");
+      info(`session troubleshoot: launching cc-hub run (interactive) for ${match.filePath}`);
+      args = ["run", promptText];
+    } else {
+      console.log("Launching Claude Code with prompt...");
+      info(`session troubleshoot: launching cc-hub run -p "${promptText}"`);
+      args = ["run", "-p", promptText];
+    }
+    const result = spawnSync3(nodeBinary, [scriptPath, ...args], {
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    process.exit(result.status ?? 1);
+  }));
   return session;
 }
 
@@ -1941,7 +2162,7 @@ _cc-hub() {
   local -a commands
   commands=(
     'profile:Manage Claude CLI profiles'
-    'use:Launch Claude Code with a saved profile'
+    'use:Set a profile as the default'
     'run:Launch Claude Code using the default or a specified profile'
     'hook:Manage Claude Code hooks in settings.json'
     'session:Manage Claude Code sessions'
@@ -1985,6 +2206,7 @@ _cc-hub() {
     'ps:Show active Claude Code processes'
     'stats:Show summary statistics'
     'clean:Delete session JSONL files older than N days'
+    'troubleshoot:Launch Claude Code to troubleshoot a session file'
   )
 
   _cc_hub_profiles() {
@@ -2019,8 +2241,10 @@ _cc-hub() {
         profile)
           if (( CURRENT == 2 )); then
             _describe -t profile-subcmds 'profile subcommand' profile_subcmds
-          elif [[ $words[2] == "view" || $words[2] == "remove" || $words[2] == "default" ]]; then
+          elif [[ $words[2] == "view" || $words[2] == "remove" ]]; then
             _cc_hub_profiles
+          elif [[ $words[2] == "default" ]]; then
+            _arguments -C -S               '--built-in[Use official Anthropic models as default]'               '*:profile:_cc_hub_profiles'
           elif [[ $words[2] == "rename" ]]; then
             if (( CURRENT == 3 )); then
               _cc_hub_profiles
@@ -2052,7 +2276,7 @@ _cc-hub() {
           fi
           ;;
         use|run)
-          _cc_hub_profiles
+          _arguments -C -S             '--built-in[Use official Anthropic models (no custom profile)]'             '*:profile:_cc_hub_profiles'
           ;;
         hook)
           if (( CURRENT == 2 )); then
@@ -2062,6 +2286,8 @@ _cc-hub() {
         session)
           if (( CURRENT == 2 )); then
             _describe -t session-subcmds 'session subcommand' session_subcmds
+          elif [[ $words[2] == "troubleshoot" ]]; then
+            _arguments -C -S               '(-i --interactive)'{-i,--interactive}'[Open an interactive Claude Code window instead of a one-shot prompt]'
           fi
           ;;
       esac
@@ -2073,20 +2299,22 @@ compdef _cc-hub cc-hub
 `;
 
 // src/complete/bash.ts
-var BASH_COMPLETION = `_cc-hub_profiles() {
+var BASH_COMPLETION = `_cc-hub_profile_names() {
   local profiles_file="\${CLAUDE_PROFILES_FILE:-$HOME/.claude/profiles.json}"
   if [[ -f "$profiles_file" ]]; then
-    local names
-    names=$(command python3 -c "
+    command python3 -c "
 import json
 data = json.load(open('$profiles_file'))
 for name in data.get('profiles', {}):
     print(name)
-" 2>/dev/null)
-    COMPREPLY=($(compgen -W "$names" -- "\${cur}"))
+" 2>/dev/null
   fi
 }
 
+_cc-hub_profiles() {
+  COMPREPLY=($(compgen -W "$(_cc-hub_profile_names)" -- "\${cur}"))
+}
+
 _cc-hub_models_for_profile() {
   local profile_name="$1"
   local profiles_file="\${CLAUDE_PROFILES_FILE:-$HOME/.claude/profiles.json}"
@@ -2121,7 +2349,7 @@ _cc-hub() {
   local provider_subcmds="list"
   local provider_types="anthropic openai"
   local hooks_subcmds="list add remove enable disable"
-  local session_subcmds="list show search ps stats clean"
+  local session_subcmds="list show search ps stats clean troubleshoot"
 
   # Top-level command
   if [[ \${COMP_CWORD} -eq 1 ]]; then
@@ -2135,8 +2363,10 @@ _cc-hub() {
     profile)
       if [[ \${COMP_CWORD} -eq 2 ]]; then
         COMPREPLY=($(compgen -W "$profile_subcmds" -- "$cur"))
-      elif [[ "$prev" == "view" || "$prev" == "remove" || "$prev" == "default" ]]; then
+      elif [[ "$prev" == "view" || "$prev" == "remove" ]]; then
         _cc-hub_profiles
+      elif [[ "$prev" == "default" ]]; then
+        COMPREPLY=($(compgen -W "--built-in $(_cc-hub_profile_names)" -- "$cur"))
       elif [[ "$prev" == "rename" ]]; then
         _cc-hub_profiles
       elif [[ "$prev" == "profile" ]]; then
@@ -2162,7 +2392,11 @@ _cc-hub() {
       fi
       ;;
     use|run)
-      _cc-hub_profiles
+      if [[ "$prev" == "--built-in" ]]; then
+        :
+      else
+        COMPREPLY=($(compgen -W "--built-in $(_cc-hub_profile_names)" -- "$cur"))
+      fi
       ;;
     hook)
       if [[ \${COMP_CWORD} -eq 2 ]]; then
@@ -2172,6 +2406,13 @@ _cc-hub() {
     session)
       if [[ \${COMP_CWORD} -eq 2 ]]; then
         COMPREPLY=($(compgen -W "$session_subcmds" -- "$cur"))
+      elif [[ "\${COMP_WORDS[2]}" == "troubleshoot" ]]; then
+        if [[ "$prev" == "--interactive" || "$prev" == "-i" ]]; then
+          :
+        else
+          local troubleshoot_opts="--interactive -i"
+          COMPREPLY=($(compgen -W "$troubleshoot_opts" -- "$cur"))
+        fi
       fi
       ;;
   esac
@@ -2199,7 +2440,7 @@ var POWERSHELL_COMPLETION = `Register-ArgumentCompleter -Native -CommandName cc-
 
   $profileSubcmds = @('add', 'update', 'list', 'view', 'remove', 'rename', 'default', 'sync')
   $hookSubcmds = @('list', 'add', 'remove', 'enable', 'disable')
-  $sessionSubcmds = @('list', 'show', 'search', 'ps', 'stats', 'clean')
+  $sessionSubcmds = @('list', 'show', 'search', 'ps', 'stats', 'clean', 'troubleshoot')
   $providerSubcmds = @('list')
 
   $tokens = $commandAst.CommandElements | ForEach-Object { $_.ToString() }
@@ -2217,6 +2458,10 @@ var POWERSHELL_COMPLETION = `Register-ArgumentCompleter -Native -CommandName cc-
         $profileSubcmds | ForEach-Object { if ($_ -like "$wordToComplete*") { $_ } }
         return
       }
+      if ($tokens[2] -eq 'default' -and $tokens.Count -ge 3) {
+        $opts = @('--built-in')
+        $opts | ForEach-Object { if ($_ -like "$wordToComplete*") { $_ } }
+      }
     }
     'hook' {
       if ($tokens.Count -eq 2 -or ($tokens.Count -eq 3 -and $wordToComplete -ne '')) {
@@ -2236,6 +2481,16 @@ var POWERSHELL_COMPLETION = `Register-ArgumentCompleter -Native -CommandName cc-
         return
       }
     }
+    'use' {
+      $opts = @('--built-in')
+      $opts | ForEach-Object { if ($_ -like "$wordToComplete*") { $_ } }
+      return
+    }
+    'run' {
+      $opts = @('--built-in')
+      $opts | ForEach-Object { if ($_ -like "$wordToComplete*") { $_ } }
+      return
+    }
   }
 }`;
 
@@ -2275,6 +2530,7 @@ program.addCommand(hooksCommand());
 program.addCommand(sessionCommand());
 program.addCommand(completionCommand());
 program.addCommand(providerCommand());
+program.addCommand(proxyCommand());
 try {
   program.parse();
 } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-hub-cli",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "Manage Claude CLI profiles, hooks, and sessions",
   "type": "module",
   "bin": {