showpane 0.4.2 → 0.4.3

package/README.md

@@ -24,6 +24,18 @@ Flags:
 Authenticate with Showpane Cloud for hosted portal deployment.
 This is auth only — org creation and billing happen in the Showpane Cloud web app.
 
+### `showpane claude`
+Resume your Showpane workspace by launching Claude Code in the right project directory.
+
+Flags:
+
+- `--project <name-or-path>` — open a specific remembered workspace
+- `--yes` / `--name <company>` — only used when no workspace exists yet and Showpane needs to create the first one
+- `--verbose` — show raw setup logs during first-time onboarding
+
+### `showpane projects`
+List remembered Showpane workspaces and show which one is currently active for global skills.
+
 ### `showpane sync`
 Install or refresh the global Showpane toolchain and Claude Code skills for the current CLI version.
 

package/bundle/meta/scaffold-manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-04-09T11:11:24.207Z",
+  "generatedAt": "2026-04-09T11:52:07.132Z",
   "scaffoldVersion": "0.2.0",
   "files": {
     ".env.example": "0dd692f1c7e6bcabdf5dbdfe9abb73797d79d8e90da150d6098b63ddc695dc29",
@@ -47,7 +47,7 @@
     "src/app/api/health/route.ts": "78fff55707372ce0cd6e9e49ef4f049622bc43cc42916d3f83e0162409d678b1",
     "src/app/globals.css": "28dcda76006d0e6af01b6dcf1a315dc5b5b6931c880fc53fd6565ff09d5dd13a",
     "src/app/layout.tsx": "c17aabeb2b486f023e777230343ace6cc06840f641a10b9dd9f65e092018f82f",
-    "src/app/page.tsx": "f5c88e28ee73acfdde347ceae6602717923a01357f56375a66e9cdd403b06992",
+    "src/app/page.tsx": "a0778e98016957ce4ccdb58fae9be0a4a71e1961fd39a2dfca1612914179b1ae",
     "src/components/portal-login.tsx": "8b0d91bb28674e1102fd2e5b5ddcc3a93755dd806fbd3d1b2dbea2646cffca5e",
     "src/components/portal-shell.tsx": "a4e16e118ef93f79e71fb69e80f1fac6e6fff90f0fbdacdf8deb821a57656877",
     "src/lib/abuse-controls.ts": "d79d58d93267aca48ad0b7b9b91f753c9a3c27263e4e98daf768a950c44a6fc6",

package/bundle/scaffold/src/app/page.tsx

@@ -2,6 +2,8 @@ import { prisma } from "@/lib/db";
 import { getRuntimeState, isRuntimeSnapshotMode } from "@/lib/runtime-state";
 import Link from "next/link";
 import { Presentation, Briefcase, UserPlus } from "lucide-react";
+import os from "node:os";
+import path from "node:path";
 
 const templates = [
   {
@@ -23,6 +25,10 @@ const templates = [
 
 export default async function Home() {
   let portalCount = 0;
+  const showpaneBinDir = path.join(os.homedir(), ".showpane", "bin");
+  const resumeCommand = (process.env.PATH ?? "").split(path.delimiter).includes(showpaneBinDir)
+    ? "showpane claude"
+    : "npx showpane claude";
   try {
     if (isRuntimeSnapshotMode()) {
       const state = await getRuntimeState();
@@ -77,10 +83,10 @@ export default async function Home() {
                 </span>
                 <div className="min-w-0">
                   <p className="text-gray-900 font-medium mb-2">
-                    Open your terminal in this directory
+                    In a terminal, reopen your Showpane workspace
                   </p>
                   <code className="block text-sm text-gray-300 font-mono bg-[#111827] px-3 py-2 rounded overflow-x-auto">
-                    cd app
+                    {resumeCommand}
                   </code>
                 </div>
               </div>
@@ -93,10 +99,10 @@ export default async function Home() {
                 </span>
                 <div className="min-w-0">
                   <p className="text-gray-900 font-medium mb-2">
-                    Launch Claude Code
+                    Use the fast path slash command
                   </p>
                   <code className="block text-sm text-gray-300 font-mono bg-[#111827] px-3 py-2 rounded">
-                    claude
+                    /portal create acme-health
                   </code>
                 </div>
               </div>
@@ -109,7 +115,7 @@ export default async function Home() {
                 </span>
                 <div className="min-w-0">
                   <p className="text-gray-900 font-medium mb-2">
-                    Tell it what to create
+                    Or tell it what to create
                   </p>
                   <code className="block text-sm text-gray-300 font-mono bg-[#111827] px-3 py-2 rounded overflow-x-auto">
                     Create a portal for my call with [client name]

package/dist/index.js

@@ -23,7 +23,7 @@ var {
   unlinkSync,
   writeFileSync
 } = fs;
-var { dirname, join, resolve } = path;
+var { basename, dirname, join, resolve } = path;
 var { homedir } = os;
 var RESET = "\x1B[0m";
 var BOLD = "\x1B[1m";
@@ -34,6 +34,7 @@ var WHITE = "\x1B[37m";
 var RED = "\x1B[31m";
 var API_BASE = "https://app.showpane.com";
 var SHOWPANE_HOME = join(homedir(), ".showpane");
+var SHOWPANE_BIN_DIR = join(SHOWPANE_HOME, "bin");
 var TOOLCHAIN_DIR = join(SHOWPANE_HOME, "toolchains");
 var CURRENT_TOOLCHAIN_LINK = join(SHOWPANE_HOME, "current");
 var CLAUDE_SKILLS_DIR = join(homedir(), ".claude", "skills");
@@ -61,6 +62,9 @@ function error(message) {
 function printCreateUsage() {
   console.log("Usage: showpane [--yes --name <company>] [--no-open] [--verbose]");
 }
+function printClaudeUsage() {
+  console.log("Usage: showpane claude [--project <name-or-path>] [--yes --name <company>] [--verbose]");
+}
 function printBanner() {
   const banner = `
 ${BOLD}${WHITE}  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557    \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557
@@ -121,6 +125,51 @@ function parseCreateArgs(args) {
   }
   return options;
 }
+function parseClaudeArgs(args) {
+  const options = {
+    noOpen: false,
+    verbose: false,
+    yes: false
+  };
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--yes") {
+      options.yes = true;
+      continue;
+    }
+    if (arg === "--no-open") {
+      options.noOpen = true;
+      continue;
+    }
+    if (arg === "--verbose") {
+      options.verbose = true;
+      continue;
+    }
+    if (arg === "--name") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new Error("Missing value for --name.");
+      }
+      options.companyName = value.trim();
+      index += 1;
+      continue;
+    }
+    if (arg === "--project") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new Error("Missing value for --project.");
+      }
+      options.project = value.trim();
+      index += 1;
+      continue;
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+  if (options.project && options.companyName) {
+    throw new Error("`--project` can not be combined with `--name`.");
+  }
+  return options;
+}
 function toSlug(name) {
   return name.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
 }
@@ -179,6 +228,21 @@ function maybePrintShowpaneUpdateMessage(currentVersion) {
   } catch {
   }
 }
+function normalizePathForComparison(targetPath) {
+  const normalized = path.normalize(resolve(targetPath));
+  return process.platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+function isShowpaneShimOnPath() {
+  const pathValue = process.env.PATH ?? "";
+  const binDir = normalizePathForComparison(SHOWPANE_BIN_DIR);
+  return pathValue.split(path.delimiter).filter(Boolean).some((entry) => normalizePathForComparison(entry) === binDir);
+}
+function getResumeCommand() {
+  return isShowpaneShimOnPath() ? "showpane claude" : "npx showpane claude";
+}
+function getResumeHint() {
+  return isShowpaneShimOnPath() ? null : `Optional: add ${SHOWPANE_BIN_DIR} to your PATH to use ${BOLD}showpane${RESET} directly.`;
+}
 function getCommandOutput(errorLike) {
   const error2 = errorLike;
   const stdout = typeof error2?.stdout === "string" ? error2.stdout : error2?.stdout?.toString() ?? "";
@@ -209,13 +273,48 @@ function runInstallerCommand(command2, cwd, env, verbose) {
   }
   runQuiet(command2, cwd, env);
 }
-function stepStart(label) {
-  blue(label);
+var activeSpinner = null;
+function renderSpinner(label, frame, startedAt) {
+  const elapsedSeconds = Math.max(0, Math.floor((Date.now() - startedAt) / 1e3));
+  const elapsed = elapsedSeconds > 0 ? ` ${DIM}${elapsedSeconds}s${RESET}` : "";
+  process.stdout.write(`\r  ${BLUE}${frame}${RESET} ${label}...${elapsed}\x1B[K`);
+}
+function stopSpinner(clearLine = true) {
+  if (!activeSpinner) return;
+  clearInterval(activeSpinner.interval);
+  if (clearLine) {
+    process.stdout.write("\r\x1B[K");
+  } else {
+    process.stdout.write("\n");
+  }
+  activeSpinner = null;
+}
+function stepStart(label, spinner = false) {
+  stopSpinner();
+  if (!spinner) {
+    blue(label);
+    return;
+  }
+  const frames = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+  let frameIndex = 0;
+  const startedAt = Date.now();
+  renderSpinner(label, frames[frameIndex], startedAt);
+  const interval = setInterval(() => {
+    frameIndex = (frameIndex + 1) % frames.length;
+    renderSpinner(label, frames[frameIndex], startedAt);
+  }, 80);
+  activeSpinner = {
+    interval,
+    label,
+    startedAt
+  };
 }
 function stepSuccess(label) {
+  stopSpinner();
   green(label);
 }
 function stepFailure(label, errorLike, hint) {
+  stopSpinner();
   error(`${label} failed.`);
   const message = errorLike instanceof Error ? errorLike.message : String(errorLike);
   const output = errorLike instanceof StepCommandError ? errorLike.output : getCommandOutput(errorLike);
@@ -232,6 +331,13 @@ function stepFailure(label, errorLike, hint) {
   }
   process.exit(1);
 }
+function attachSpinnerCleanup() {
+  const cleanup = () => stopSpinner();
+  process.on("exit", cleanup);
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+}
+attachSpinnerCleanup();
 function openBrowser(url) {
   const platform = process.platform;
   const command2 = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
@@ -245,6 +351,101 @@ function writeJson(filePath, value) {
   writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
 `);
 }
+function getShowpaneConfigPath() {
+  return join(SHOWPANE_HOME, "config.json");
+}
+function readShowpaneConfig() {
+  const configPath = getShowpaneConfigPath();
+  if (!existsSync(configPath)) {
+    return {};
+  }
+  return readJson(configPath);
+}
+function writeShowpaneConfig(config) {
+  ensureDir(SHOWPANE_HOME);
+  const configPath = getShowpaneConfigPath();
+  writeJson(configPath, config);
+  chmodSync(configPath, 384);
+}
+function findWorkspaceRoot(startPath) {
+  let currentPath = resolve(startPath);
+  while (true) {
+    if (existsSync(join(currentPath, "package.json")) && existsSync(join(currentPath, "prisma", "schema.prisma")) && existsSync(getProjectMetadataPath(currentPath))) {
+      return currentPath;
+    }
+    const parentPath = dirname(currentPath);
+    if (parentPath === currentPath) {
+      return null;
+    }
+    currentPath = parentPath;
+  }
+}
+function defaultWorkspaceEntry(projectPath, overrides) {
+  return {
+    name: basename(projectPath),
+    path: resolve(projectPath),
+    lastUsedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    deployMode: "local",
+    orgSlug: "",
+    ...overrides
+  };
+}
+function getWorkspaceEntries(config) {
+  const workspaces = [...config.workspaces ?? []];
+  const activePath = config.app_path ? resolve(config.app_path) : null;
+  if (activePath && !workspaces.some((workspace) => normalizePathForComparison(workspace.path) === normalizePathForComparison(activePath))) {
+    workspaces.push(defaultWorkspaceEntry(activePath, {
+      deployMode: typeof config.deploy_mode === "string" ? config.deploy_mode : "local",
+      orgSlug: typeof config.orgSlug === "string" ? config.orgSlug : ""
+    }));
+  }
+  return workspaces.map((workspace) => ({
+    ...workspace,
+    path: resolve(workspace.path),
+    lastUsedAt: workspace.lastUsedAt || (/* @__PURE__ */ new Date(0)).toISOString(),
+    deployMode: workspace.deployMode || "local",
+    orgSlug: workspace.orgSlug || ""
+  })).sort((left, right) => right.lastUsedAt.localeCompare(left.lastUsedAt));
+}
+function setActiveWorkspace(config, workspace) {
+  config.app_path = workspace.path;
+  config.deploy_mode = workspace.deployMode;
+  config.orgSlug = workspace.orgSlug;
+}
+function upsertWorkspace(config, workspace, makeActive = true) {
+  const workspaces = getWorkspaceEntries(config).filter(
+    (entry) => normalizePathForComparison(entry.path) !== normalizePathForComparison(workspace.path)
+  );
+  workspaces.push(workspace);
+  config.workspaces = workspaces.sort((left, right) => right.lastUsedAt.localeCompare(left.lastUsedAt));
+  if (makeActive) {
+    setActiveWorkspace(config, workspace);
+  }
+}
+function updateWorkspaceFromConfig(config, projectPath, overrides) {
+  const workspace = defaultWorkspaceEntry(projectPath, {
+    deployMode: typeof config.deploy_mode === "string" ? config.deploy_mode : "local",
+    orgSlug: typeof config.orgSlug === "string" ? config.orgSlug : "",
+    ...overrides
+  });
+  upsertWorkspace(config, workspace, true);
+  return workspace;
+}
+function ensureShowpaneShim() {
+  ensureDir(SHOWPANE_BIN_DIR);
+  const shellShim = join(SHOWPANE_BIN_DIR, "showpane");
+  writeFileSync(
+    shellShim,
+    '#!/bin/sh\nexec npx --yes showpane "$@"\n'
+  );
+  chmodSync(shellShim, 493);
+  if (process.platform === "win32") {
+    writeFileSync(
+      join(SHOWPANE_BIN_DIR, "showpane.cmd"),
+      "@echo off\r\nnpx --yes showpane %*\r\n"
+    );
+  }
+}
 function ensureDir(dirPath) {
   mkdirSync(dirPath, { recursive: true });
 }
@@ -581,7 +782,9 @@ function installSharedSkillProjection(toolchainRoot) {
     process.platform === "win32" ? "junction" : "dir"
   );
 }
-function printCreateSuccessCard(projectRoot, projectName, url) {
+function printCreateSuccessCard(projectRoot, url) {
+  const resumeCommand = getResumeCommand();
+  const resumeHint = getResumeHint();
   console.log();
   console.log(`  ${GREEN}Showpane is ready${RESET}`);
   console.log();
@@ -590,10 +793,14 @@ function printCreateSuccessCard(projectRoot, projectName, url) {
   console.log(`  ${BOLD}Demo:${RESET}    example / demo-only-password`);
   console.log();
   console.log(`  ${BOLD}Next:${RESET}`);
-  console.log(`    ${DIM}cd ${projectName} && claude${RESET}`);
+  console.log(`    ${DIM}${resumeCommand}${RESET}`);
   console.log();
   console.log(`  ${BOLD}Try:${RESET}`);
   console.log(`    ${DIM}Create a portal for my call with Acme Health${RESET}`);
+  if (resumeHint) {
+    console.log();
+    console.log(`  ${DIM}${resumeHint}${RESET}`);
+  }
   console.log();
 }
 function startDevServer(projectRoot, databaseUrl, noOpen, verbose) {
@@ -650,6 +857,93 @@ function startDevServer(projectRoot, databaseUrl, noOpen, verbose) {
     });
   });
 }
+function resolveWorkspaceSelection(config, specifier) {
+  const workspaces = getWorkspaceEntries(config);
+  if (!specifier) {
+    return workspaces;
+  }
+  const asPathRoot = findWorkspaceRoot(specifier);
+  if (asPathRoot) {
+    return [defaultWorkspaceEntry(asPathRoot)];
+  }
+  const normalizedSpecifier = normalizePathForComparison(specifier);
+  const pathMatches = workspaces.filter(
+    (workspace) => normalizePathForComparison(workspace.path) === normalizedSpecifier
+  );
+  if (pathMatches.length > 0) {
+    return pathMatches;
+  }
+  const nameMatches = workspaces.filter((workspace) => workspace.name === specifier);
+  return nameMatches;
+}
+async function promptWorkspaceSelection(workspaces) {
+  console.log();
+  console.log(`  ${BOLD}Select a Showpane workspace${RESET}`);
+  console.log();
+  for (const [index, workspace] of workspaces.entries()) {
+    console.log(`  ${index + 1}. ${workspace.name}`);
+    console.log(`     ${DIM}${workspace.path}${RESET}`);
+    console.log(`     ${DIM}Last used: ${workspace.lastUsedAt}${RESET}`);
+  }
+  console.log();
+  while (true) {
+    const answer = await ask(`  ${BOLD}Choose a workspace [1-${workspaces.length}] or q to cancel:${RESET} `);
+    if (!answer) continue;
+    if (answer.toLowerCase() === "q") {
+      process.exit(0);
+    }
+    const selectedIndex = Number.parseInt(answer, 10);
+    if (Number.isInteger(selectedIndex) && selectedIndex >= 1 && selectedIndex <= workspaces.length) {
+      return workspaces[selectedIndex - 1];
+    }
+  }
+}
+function printWorkspaceList(config) {
+  printBanner();
+  const workspaces = getWorkspaceEntries(config);
+  if (workspaces.length === 0) {
+    console.log();
+    blue("No Showpane workspaces found");
+    console.log(`  ${DIM}Run: npx showpane${RESET}`);
+    console.log();
+    return;
+  }
+  const activePath = config.app_path ? normalizePathForComparison(config.app_path) : null;
+  console.log();
+  console.log(`  ${BOLD}Showpane workspaces${RESET}`);
+  console.log();
+  for (const [index, workspace] of workspaces.entries()) {
+    const isActive = activePath !== null && normalizePathForComparison(workspace.path) === activePath;
+    const marker = isActive ? "*" : " ";
+    console.log(`  ${marker} ${index + 1}. ${workspace.name}`);
+    console.log(`     ${workspace.path}`);
+    console.log(`     ${DIM}Last used: ${workspace.lastUsedAt}${RESET}`);
+  }
+  console.log();
+}
+async function openClaudeInWorkspace(workspace) {
+  if (!commandExists("claude")) {
+    throw new Error("Claude Code is not installed or not on PATH.");
+  }
+  blue(`Opening ${workspace.name} workspace`);
+  console.log(`  ${DIM}${workspace.path}${RESET}`);
+  console.log();
+  await new Promise((resolveLaunch, rejectLaunch) => {
+    const child = spawn("claude", [], {
+      cwd: workspace.path,
+      stdio: "inherit",
+      env: {
+        ...process.env,
+        SHOWPANE_APP_PATH: workspace.path,
+        SHOWPANE_TOOLCHAIN_DIR: CURRENT_TOOLCHAIN_LINK
+      }
+    });
+    child.on("error", rejectLaunch);
+    child.on("close", (code) => {
+      process.exit(code ?? 0);
+    });
+  });
+}
 function installSkillProjection(toolchainRoot) {
   removePath(join(CLAUDE_SKILLS_DIR, "showpane"));
   installSharedSkillProjection(toolchainRoot);
@@ -736,6 +1030,7 @@ async function createProject(args) {
     process.exit(1);
   }
   printBanner();
+  ensureShowpaneShim();
   const companyName = options.companyName ?? await ask(`  ${BOLD}What's your company name?${RESET} `);
   if (!companyName) {
     error("Company name is required.");
@@ -793,6 +1088,13 @@ AUTH_SECRET="${authSecret}"
   let toolchainInfo;
   try {
     toolchainInfo = syncToolchain(bundleRoot, showpaneVersion, false);
+    const config = readShowpaneConfig();
+    updateWorkspaceFromConfig(config, projectRoot, {
+      name: dirName,
+      deployMode: "local",
+      orgSlug: ""
+    });
+    writeShowpaneConfig(config);
     writeProjectState(
       projectRoot,
       showpaneVersion,
@@ -824,7 +1126,7 @@ AUTH_SECRET="${authSecret}"
       `Run ${BOLD}cd ${dirName} && npm run dev${RESET} for more detail.`
     );
   }
-  printCreateSuccessCard(projectRoot, dirName, serverStart.url);
+  printCreateSuccessCard(projectRoot, serverStart.url);
   serverStart.devServer.on("close", (code) => {
     if (code !== 0) {
       error(`Dev server exited with code ${code}`);
@@ -842,6 +1144,7 @@ async function syncCurrentToolchain() {
   const packageRoot2 = getPackageRoot();
   const bundleRoot = getLocalBundleRoot(packageRoot2);
   const showpaneVersion = getPackageVersion(packageRoot2);
+  ensureShowpaneShim();
   printBanner();
   maybePrintShowpaneUpdateMessage(showpaneVersion);
   console.log();
@@ -914,8 +1217,73 @@ async function upgradeProject(args) {
     bundleSource.cleanup();
   }
 }
+async function openClaude(args) {
+  let options;
+  try {
+    options = parseClaudeArgs(args);
+  } catch (errorLike) {
+    printBanner();
+    console.log();
+    error(errorLike instanceof Error ? errorLike.message : String(errorLike));
+    printClaudeUsage();
+    process.exit(1);
+  }
+  ensureShowpaneShim();
+  const config = readShowpaneConfig();
+  const workspaces = getWorkspaceEntries(config);
+  if (workspaces.length === 0 && !options.project) {
+    blue("No Showpane workspace found. Let's create one first.");
+    console.log();
+    await createProject(args);
+    return;
+  }
+  if (workspaces.length > 0 && (options.companyName || options.yes)) {
+    error("`--yes` and `--name` only apply when creating the first workspace.");
+    printClaudeUsage();
+    process.exit(1);
+  }
+  let workspace;
+  if (options.project) {
+    const matches = resolveWorkspaceSelection(config, options.project);
+    if (matches.length === 0) {
+      error(`Could not find a Showpane workspace matching: ${options.project}`);
+      process.exit(1);
+    }
+    if (matches.length > 1) {
+      error(`Multiple workspaces matched: ${options.project}`);
+      for (const match of matches) {
+        console.error(`    ${match.name} \u2014 ${match.path}`);
+      }
+      process.exit(1);
+    }
+    workspace = matches[0];
+  } else if (workspaces.length === 1) {
+    workspace = workspaces[0];
+  } else if (!process.stdout.isTTY) {
+    error("Multiple Showpane workspaces found. Use `showpane claude --project <name-or-path>`.");
+    process.exit(1);
+  } else {
+    workspace = await promptWorkspaceSelection(workspaces);
+  }
+  const workspaceRoot = findWorkspaceRoot(workspace.path) ?? resolve(workspace.path);
+  const selectedWorkspace = defaultWorkspaceEntry(workspaceRoot, {
+    name: workspace.name || basename(workspaceRoot),
+    deployMode: workspace.deployMode || "local",
+    orgSlug: workspace.orgSlug || ""
+  });
+  upsertWorkspace(config, selectedWorkspace, true);
+  writeShowpaneConfig(config);
+  try {
+    await openClaudeInWorkspace(selectedWorkspace);
+  } catch (errorLike) {
+    error(errorLike instanceof Error ? errorLike.message : String(errorLike));
+    console.error(`Hint: Install Claude Code first, or use ${getResumeCommand()} later.`);
+    process.exit(1);
+  }
+}
 async function login() {
   printBanner();
+  ensureShowpaneShim();
   blue("Authenticating with Showpane...");
   console.log();
   const initRes = await fetch(`${API_BASE}/api/cli/init`, { method: "POST" });
@@ -944,26 +1312,23 @@ async function login() {
     }
     const data = await pollRes.json();
     if (data.status !== "approved") continue;
-    const configDir = join(homedir(), ".showpane");
-    mkdirSync(configDir, { recursive: true });
-    const configPath = join(configDir, "config.json");
-    writeFileSync(
-      configPath,
-      JSON.stringify(
-        {
-          accessToken: data.accessToken,
-          accessTokenExpiresAt: data.tokenExpiresAt,
-          orgSlug: data.orgSlug,
-          portalUrl: data.portalUrl,
-          vercelProjectId: data.vercelProjectId,
-          app_path: process.cwd(),
-          deploy_mode: "cloud"
-        },
-        null,
-        2
-      )
-    );
-    chmodSync(configPath, 384);
+    const config = readShowpaneConfig();
+    config.accessToken = data.accessToken;
+    config.accessTokenExpiresAt = data.tokenExpiresAt;
+    config.orgSlug = data.orgSlug;
+    config.portalUrl = data.portalUrl;
+    config.vercelProjectId = data.vercelProjectId;
+    const currentWorkspace = findWorkspaceRoot(process.cwd()) ?? (config.app_path ? findWorkspaceRoot(config.app_path) ?? resolve(config.app_path) : null);
+    if (currentWorkspace) {
+      updateWorkspaceFromConfig(config, currentWorkspace, {
+        name: basename(currentWorkspace),
+        deployMode: "cloud",
+        orgSlug: data.orgSlug
+      });
+    } else {
+      config.deploy_mode = "cloud";
+    }
+    writeShowpaneConfig(config);
     console.log();
     green(`Authenticated! Connected to ${BOLD}${data.orgSlug}${RESET}`);
     console.log();
@@ -983,6 +1348,18 @@ if (command === "login") {
     error(String(err));
     process.exit(1);
   });
+} else if (command === "claude") {
+  openClaude(process.argv.slice(3)).catch((err) => {
+    error(String(err));
+    process.exit(1);
+  });
+} else if (command === "projects") {
+  try {
+    printWorkspaceList(readShowpaneConfig());
+  } catch (err) {
+    error(String(err));
+    process.exit(1);
+  }
 } else if (command === "sync") {
   syncCurrentToolchain().catch((err) => {
     error(String(err));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "showpane",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "CLI for Showpane — AI-generated client portals",
   "type": "module",
   "bin": {