lcclaude 1.0.0

package/dist/src/commands/terminalSetup/terminalSetup.js

@@ -0,0 +1,425 @@
+import chalk from "chalk";
+import { randomBytes } from "crypto";
+import { copyFile, mkdir, readFile, writeFile } from "fs/promises";
+import { homedir, platform } from "os";
+import { dirname, join } from "path";
+import { pathToFileURL } from "url";
+import { supportsHyperlinks } from "../../ink/supports-hyperlinks.js";
+import { color } from "../../ink.js";
+import { maybeMarkProjectOnboardingComplete } from "../../projectOnboardingState.js";
+import { backupTerminalPreferences, checkAndRestoreTerminalBackup, getTerminalPlistPath, markTerminalSetupComplete } from "../../utils/appleTerminalBackup.js";
+import { setupShellCompletion } from "../../utils/completionCache.js";
+import { getGlobalConfig, saveGlobalConfig } from "../../utils/config.js";
+import { env } from "../../utils/env.js";
+import { isFsInaccessible } from "../../utils/errors.js";
+import { execFileNoThrow } from "../../utils/execFileNoThrow.js";
+import { addItemToJSONCArray, safeParseJSONC } from "../../utils/json.js";
+import { logError } from "../../utils/log.js";
+import { getPlatform } from "../../utils/platform.js";
+import { jsonParse, jsonStringify } from "../../utils/slowOperations.js";
+const EOL = `
+`;
+const NATIVE_CSIU_TERMINALS = {
+  ghostty: "Ghostty",
+  kitty: "Kitty",
+  "iTerm.app": "iTerm2",
+  WezTerm: "WezTerm",
+  WarpTerminal: "Warp"
+};
+function isVSCodeRemoteSSH() {
+  const askpassMain = process.env.VSCODE_GIT_ASKPASS_MAIN ?? "";
+  const path = process.env.PATH ?? "";
+  return askpassMain.includes(".vscode-server") || askpassMain.includes(".cursor-server") || askpassMain.includes(".windsurf-server") || path.includes(".vscode-server") || path.includes(".cursor-server") || path.includes(".windsurf-server");
+}
+export function getNativeCSIuTerminalDisplayName() {
+  if (!env.terminal || !(env.terminal in NATIVE_CSIU_TERMINALS)) {
+    return null;
+  }
+  return NATIVE_CSIU_TERMINALS[env.terminal] ?? null;
+}
+function formatPathLink(filePath) {
+  if (!supportsHyperlinks()) {
+    return filePath;
+  }
+  const fileUrl = pathToFileURL(filePath).href;
+  return `\x1B]8;;${fileUrl}\x07${filePath}\x1B]8;;\x07`;
+}
+export function shouldOfferTerminalSetup() {
+  return platform() === "darwin" && env.terminal === "Apple_Terminal" || env.terminal === "vscode" || env.terminal === "cursor" || env.terminal === "windsurf" || env.terminal === "alacritty" || env.terminal === "zed";
+}
+export async function setupTerminal(theme) {
+  let result = "";
+  switch (env.terminal) {
+    case "Apple_Terminal":
+      result = await enableOptionAsMetaForTerminal(theme);
+      break;
+    case "vscode":
+      result = await installBindingsForVSCodeTerminal("VSCode", theme);
+      break;
+    case "cursor":
+      result = await installBindingsForVSCodeTerminal("Cursor", theme);
+      break;
+    case "windsurf":
+      result = await installBindingsForVSCodeTerminal("Windsurf", theme);
+      break;
+    case "alacritty":
+      result = await installBindingsForAlacritty(theme);
+      break;
+    case "zed":
+      result = await installBindingsForZed(theme);
+      break;
+    case null:
+      break;
+  }
+  saveGlobalConfig((current) => {
+    if (["vscode", "cursor", "windsurf", "alacritty", "zed"].includes(env.terminal ?? "")) {
+      if (current.shiftEnterKeyBindingInstalled === true)
+        return current;
+      return {
+        ...current,
+        shiftEnterKeyBindingInstalled: true
+      };
+    } else if (env.terminal === "Apple_Terminal") {
+      if (current.optionAsMetaKeyInstalled === true)
+        return current;
+      return {
+        ...current,
+        optionAsMetaKeyInstalled: true
+      };
+    }
+    return current;
+  });
+  maybeMarkProjectOnboardingComplete();
+  if (false) {}
+  return result;
+}
+export function isShiftEnterKeyBindingInstalled() {
+  return getGlobalConfig().shiftEnterKeyBindingInstalled === true;
+}
+export function hasUsedBackslashReturn() {
+  return getGlobalConfig().hasUsedBackslashReturn === true;
+}
+export function markBackslashReturnUsed() {
+  const config = getGlobalConfig();
+  if (!config.hasUsedBackslashReturn) {
+    saveGlobalConfig((current) => ({
+      ...current,
+      hasUsedBackslashReturn: true
+    }));
+  }
+}
+export async function call(onDone, context, _args) {
+  if (env.terminal && env.terminal in NATIVE_CSIU_TERMINALS) {
+    const message = `Shift+Enter is natively supported in ${NATIVE_CSIU_TERMINALS[env.terminal]}.
+
+No configuration needed. Just use Shift+Enter to add newlines.`;
+    onDone(message);
+    return null;
+  }
+  if (!shouldOfferTerminalSetup()) {
+    const terminalName = env.terminal || "your current terminal";
+    const currentPlatform = getPlatform();
+    let platformTerminals = "";
+    if (currentPlatform === "macos") {
+      platformTerminals = `   • macOS: Apple Terminal
+`;
+    } else if (currentPlatform === "windows") {
+      platformTerminals = `   • Windows: Windows Terminal
+`;
+    }
+    const message = `Terminal setup cannot be run from ${terminalName}.
+
+This command configures a convenient Shift+Enter shortcut for multi-line prompts.
+${chalk.dim("Note: You can already use backslash (\\\\) + return to add newlines.")}
+
+To set up the shortcut (optional):
+1. Exit tmux/screen temporarily
+2. Run /terminal-setup directly in one of these terminals:
+${platformTerminals}   • IDE: VSCode, Cursor, Windsurf, Zed
+   • Other: Alacritty
+3. Return to tmux/screen - settings will persist
+
+${chalk.dim("Note: iTerm2, WezTerm, Ghostty, Kitty, and Warp support Shift+Enter natively.")}`;
+    onDone(message);
+    return null;
+  }
+  const result = await setupTerminal(context.options.theme);
+  onDone(result);
+  return null;
+}
+async function installBindingsForVSCodeTerminal(editor = "VSCode", theme) {
+  if (isVSCodeRemoteSSH()) {
+    return `${color("warning", theme)(`Cannot install keybindings from a remote ${editor} session.`)}${EOL}${EOL}${editor} keybindings must be installed on your local machine, not the remote server.${EOL}${EOL}To install the Shift+Enter keybinding:${EOL}1. Open ${editor} on your local machine (not connected to remote)${EOL}2. Open the Command Palette (Cmd/Ctrl+Shift+P) → "Preferences: Open Keyboard Shortcuts (JSON)"${EOL}3. Add this keybinding (the file must be a JSON array):${EOL}${EOL}${chalk.dim(`[
+  {
+    "key": "shift+enter",
+    "command": "workbench.action.terminal.sendSequence",
+    "args": { "text": "\\u001b\\r" },
+    "when": "terminalFocus"
+  }
+]`)}${EOL}`;
+  }
+  const editorDir = editor === "VSCode" ? "Code" : editor;
+  const userDirPath = join(homedir(), platform() === "win32" ? join("AppData", "Roaming", editorDir, "User") : platform() === "darwin" ? join("Library", "Application Support", editorDir, "User") : join(".config", editorDir, "User"));
+  const keybindingsPath = join(userDirPath, "keybindings.json");
+  try {
+    await mkdir(userDirPath, {
+      recursive: true
+    });
+    let content = "[]";
+    let keybindings = [];
+    let fileExists = false;
+    try {
+      content = await readFile(keybindingsPath, {
+        encoding: "utf-8"
+      });
+      fileExists = true;
+      keybindings = safeParseJSONC(content) ?? [];
+    } catch (e) {
+      if (!isFsInaccessible(e))
+        throw e;
+    }
+    if (fileExists) {
+      const randomSha = randomBytes(4).toString("hex");
+      const backupPath = `${keybindingsPath}.${randomSha}.bak`;
+      try {
+        await copyFile(keybindingsPath, backupPath);
+      } catch {
+        return `${color("warning", theme)(`Error backing up existing ${editor} terminal keybindings. Bailing out.`)}${EOL}${chalk.dim(`See ${formatPathLink(keybindingsPath)}`)}${EOL}${chalk.dim(`Backup path: ${formatPathLink(backupPath)}`)}${EOL}`;
+      }
+    }
+    const existingBinding = keybindings.find((binding) => binding.key === "shift+enter" && binding.command === "workbench.action.terminal.sendSequence" && binding.when === "terminalFocus");
+    if (existingBinding) {
+      return `${color("warning", theme)(`Found existing ${editor} terminal Shift+Enter key binding. Remove it to continue.`)}${EOL}${chalk.dim(`See ${formatPathLink(keybindingsPath)}`)}${EOL}`;
+    }
+    const newKeybinding = {
+      key: "shift+enter",
+      command: "workbench.action.terminal.sendSequence",
+      args: {
+        text: "\x1B\r"
+      },
+      when: "terminalFocus"
+    };
+    const updatedContent = addItemToJSONCArray(content, newKeybinding);
+    await writeFile(keybindingsPath, updatedContent, {
+      encoding: "utf-8"
+    });
+    return `${color("success", theme)(`Installed ${editor} terminal Shift+Enter key binding`)}${EOL}${chalk.dim(`See ${formatPathLink(keybindingsPath)}`)}${EOL}`;
+  } catch (error) {
+    logError(error);
+    throw new Error(`Failed to install ${editor} terminal Shift+Enter key binding`);
+  }
+}
+async function enableOptionAsMetaForProfile(profileName) {
+  const {
+    code: addCode
+  } = await execFileNoThrow("/usr/libexec/PlistBuddy", ["-c", `Add :'Window Settings':'${profileName}':useOptionAsMetaKey bool true`, getTerminalPlistPath()]);
+  if (addCode !== 0) {
+    const {
+      code: setCode
+    } = await execFileNoThrow("/usr/libexec/PlistBuddy", ["-c", `Set :'Window Settings':'${profileName}':useOptionAsMetaKey true`, getTerminalPlistPath()]);
+    if (setCode !== 0) {
+      logError(new Error(`Failed to enable Option as Meta key for Terminal.app profile: ${profileName}`));
+      return false;
+    }
+  }
+  return true;
+}
+async function disableAudioBellForProfile(profileName) {
+  const {
+    code: addCode
+  } = await execFileNoThrow("/usr/libexec/PlistBuddy", ["-c", `Add :'Window Settings':'${profileName}':Bell bool false`, getTerminalPlistPath()]);
+  if (addCode !== 0) {
+    const {
+      code: setCode
+    } = await execFileNoThrow("/usr/libexec/PlistBuddy", ["-c", `Set :'Window Settings':'${profileName}':Bell false`, getTerminalPlistPath()]);
+    if (setCode !== 0) {
+      logError(new Error(`Failed to disable audio bell for Terminal.app profile: ${profileName}`));
+      return false;
+    }
+  }
+  return true;
+}
+async function enableOptionAsMetaForTerminal(theme) {
+  try {
+    const backupPath = await backupTerminalPreferences();
+    if (!backupPath) {
+      throw new Error("Failed to create backup of Terminal.app preferences, bailing out");
+    }
+    const {
+      stdout: defaultProfile,
+      code: readCode
+    } = await execFileNoThrow("defaults", ["read", "com.apple.Terminal", "Default Window Settings"]);
+    if (readCode !== 0 || !defaultProfile.trim()) {
+      throw new Error("Failed to read default Terminal.app profile");
+    }
+    const {
+      stdout: startupProfile,
+      code: startupCode
+    } = await execFileNoThrow("defaults", ["read", "com.apple.Terminal", "Startup Window Settings"]);
+    if (startupCode !== 0 || !startupProfile.trim()) {
+      throw new Error("Failed to read startup Terminal.app profile");
+    }
+    let wasAnyProfileUpdated = false;
+    const defaultProfileName = defaultProfile.trim();
+    const optionAsMetaEnabled = await enableOptionAsMetaForProfile(defaultProfileName);
+    const audioBellDisabled = await disableAudioBellForProfile(defaultProfileName);
+    if (optionAsMetaEnabled || audioBellDisabled) {
+      wasAnyProfileUpdated = true;
+    }
+    const startupProfileName = startupProfile.trim();
+    if (startupProfileName !== defaultProfileName) {
+      const startupOptionAsMetaEnabled = await enableOptionAsMetaForProfile(startupProfileName);
+      const startupAudioBellDisabled = await disableAudioBellForProfile(startupProfileName);
+      if (startupOptionAsMetaEnabled || startupAudioBellDisabled) {
+        wasAnyProfileUpdated = true;
+      }
+    }
+    if (!wasAnyProfileUpdated) {
+      throw new Error("Failed to enable Option as Meta key or disable audio bell for any Terminal.app profile");
+    }
+    await execFileNoThrow("killall", ["cfprefsd"]);
+    markTerminalSetupComplete();
+    return `${color("success", theme)(`Configured Terminal.app settings:`)}${EOL}${color("success", theme)('- Enabled "Use Option as Meta key"')}${EOL}${color("success", theme)("- Switched to visual bell")}${EOL}${chalk.dim("Option+Enter will now enter a newline.")}${EOL}${chalk.dim("You must restart Terminal.app for changes to take effect.", theme)}${EOL}`;
+  } catch (error) {
+    logError(error);
+    const restoreResult = await checkAndRestoreTerminalBackup();
+    const errorMessage = "Failed to enable Option as Meta key for Terminal.app.";
+    if (restoreResult.status === "restored") {
+      throw new Error(`${errorMessage} Your settings have been restored from backup.`);
+    } else if (restoreResult.status === "failed") {
+      throw new Error(`${errorMessage} Restoring from backup failed, try manually with: defaults import com.apple.Terminal ${restoreResult.backupPath}`);
+    } else {
+      throw new Error(`${errorMessage} No backup was available to restore from.`);
+    }
+  }
+}
+async function installBindingsForAlacritty(theme) {
+  const ALACRITTY_KEYBINDING = `[[keyboard.bindings]]
+key = "Return"
+mods = "Shift"
+chars = "\\u001B\\r"`;
+  const configPaths = [];
+  const xdgConfigHome = process.env.XDG_CONFIG_HOME;
+  if (xdgConfigHome) {
+    configPaths.push(join(xdgConfigHome, "alacritty", "alacritty.toml"));
+  } else {
+    configPaths.push(join(homedir(), ".config", "alacritty", "alacritty.toml"));
+  }
+  if (platform() === "win32") {
+    const appData = process.env.APPDATA;
+    if (appData) {
+      configPaths.push(join(appData, "alacritty", "alacritty.toml"));
+    }
+  }
+  let configPath = null;
+  let configContent = "";
+  let configExists = false;
+  for (const path of configPaths) {
+    try {
+      configContent = await readFile(path, {
+        encoding: "utf-8"
+      });
+      configPath = path;
+      configExists = true;
+      break;
+    } catch (e) {
+      if (!isFsInaccessible(e))
+        throw e;
+    }
+  }
+  if (!configPath) {
+    configPath = configPaths[0] ?? null;
+  }
+  if (!configPath) {
+    throw new Error("No valid config path found for Alacritty");
+  }
+  try {
+    if (configExists) {
+      if (configContent.includes('mods = "Shift"') && configContent.includes('key = "Return"')) {
+        return `${color("warning", theme)("Found existing Alacritty Shift+Enter key binding. Remove it to continue.")}${EOL}${chalk.dim(`See ${formatPathLink(configPath)}`)}${EOL}`;
+      }
+      const randomSha = randomBytes(4).toString("hex");
+      const backupPath = `${configPath}.${randomSha}.bak`;
+      try {
+        await copyFile(configPath, backupPath);
+      } catch {
+        return `${color("warning", theme)("Error backing up existing Alacritty config. Bailing out.")}${EOL}${chalk.dim(`See ${formatPathLink(configPath)}`)}${EOL}${chalk.dim(`Backup path: ${formatPathLink(backupPath)}`)}${EOL}`;
+      }
+    } else {
+      await mkdir(dirname(configPath), {
+        recursive: true
+      });
+    }
+    let updatedContent = configContent;
+    if (configContent && !configContent.endsWith(`
+`)) {
+      updatedContent += `
+`;
+    }
+    updatedContent += `
+` + ALACRITTY_KEYBINDING + `
+`;
+    await writeFile(configPath, updatedContent, {
+      encoding: "utf-8"
+    });
+    return `${color("success", theme)("Installed Alacritty Shift+Enter key binding")}${EOL}${color("success", theme)("You may need to restart Alacritty for changes to take effect")}${EOL}${chalk.dim(`See ${formatPathLink(configPath)}`)}${EOL}`;
+  } catch (error) {
+    logError(error);
+    throw new Error("Failed to install Alacritty Shift+Enter key binding");
+  }
+}
+async function installBindingsForZed(theme) {
+  const zedDir = join(homedir(), ".config", "zed");
+  const keymapPath = join(zedDir, "keymap.json");
+  try {
+    await mkdir(zedDir, {
+      recursive: true
+    });
+    let keymapContent = "[]";
+    let fileExists = false;
+    try {
+      keymapContent = await readFile(keymapPath, {
+        encoding: "utf-8"
+      });
+      fileExists = true;
+    } catch (e) {
+      if (!isFsInaccessible(e))
+        throw e;
+    }
+    if (fileExists) {
+      if (keymapContent.includes("shift-enter")) {
+        return `${color("warning", theme)("Found existing Zed Shift+Enter key binding. Remove it to continue.")}${EOL}${chalk.dim(`See ${formatPathLink(keymapPath)}`)}${EOL}`;
+      }
+      const randomSha = randomBytes(4).toString("hex");
+      const backupPath = `${keymapPath}.${randomSha}.bak`;
+      try {
+        await copyFile(keymapPath, backupPath);
+      } catch {
+        return `${color("warning", theme)("Error backing up existing Zed keymap. Bailing out.")}${EOL}${chalk.dim(`See ${formatPathLink(keymapPath)}`)}${EOL}${chalk.dim(`Backup path: ${formatPathLink(backupPath)}`)}${EOL}`;
+      }
+    }
+    let keymap;
+    try {
+      keymap = jsonParse(keymapContent);
+      if (!Array.isArray(keymap)) {
+        keymap = [];
+      }
+    } catch {
+      keymap = [];
+    }
+    keymap.push({
+      context: "Terminal",
+      bindings: {
+        "shift-enter": ["terminal::SendText", "\x1B\r"]
+      }
+    });
+    await writeFile(keymapPath, jsonStringify(keymap, null, 2) + `
+`, {
+      encoding: "utf-8"
+    });
+    return `${color("success", theme)("Installed Zed Shift+Enter key binding")}${EOL}${chalk.dim(`See ${formatPathLink(keymapPath)}`)}${EOL}`;
+  } catch (error) {
+    logError(error);
+    throw new Error("Failed to install Zed Shift+Enter key binding");
+  }
+}

package/dist/src/commands/theme/index.js

@@ -0,0 +1,7 @@
+const theme = {
+  type: "local-jsx",
+  name: "theme",
+  description: "Change the theme",
+  load: () => import("./theme.js")
+};
+export default theme;

package/dist/src/commands/theme/theme.js

@@ -0,0 +1,58 @@
+import { c as _c } from "react/compiler-runtime";
+import * as React from "react";
+import { Pane } from "../../components/design-system/Pane.js";
+import { ThemePicker } from "../../components/ThemePicker.js";
+import { useTheme } from "../../ink.js";
+function ThemePickerCommand(t0) {
+  const $ = _c(8);
+  const {
+    onDone
+  } = t0;
+  const [, setTheme] = useTheme();
+  let t1;
+  if ($[0] !== onDone || $[1] !== setTheme) {
+    t1 = (setting) => {
+      setTheme(setting);
+      onDone(`Theme set to ${setting}`);
+    };
+    $[0] = onDone;
+    $[1] = setTheme;
+    $[2] = t1;
+  } else {
+    t1 = $[2];
+  }
+  let t2;
+  if ($[3] !== onDone) {
+    t2 = () => {
+      onDone("Theme picker dismissed", {
+        display: "system"
+      });
+    };
+    $[3] = onDone;
+    $[4] = t2;
+  } else {
+    t2 = $[4];
+  }
+  let t3;
+  if ($[5] !== t1 || $[6] !== t2) {
+    t3 = jsxDEV_7x81h0kn(Pane, {
+      color: "permission",
+      children: jsxDEV_7x81h0kn(ThemePicker, {
+        onThemeSelect: t1,
+        onCancel: t2,
+        skipExitHandling: true
+      }, undefined, false, undefined, this)
+    }, undefined, false, undefined, this);
+    $[5] = t1;
+    $[6] = t2;
+    $[7] = t3;
+  } else {
+    t3 = $[7];
+  }
+  return t3;
+}
+export const call = async (onDone, _context) => {
+  return jsxDEV_7x81h0kn(ThemePickerCommand, {
+    onDone
+  }, undefined, false, undefined, this);
+};

package/dist/src/commands/thinkback/index.js

@@ -0,0 +1,9 @@
+import { checkStatsigFeatureGate_CACHED_MAY_BE_STALE } from "../../services/analytics/growthbook.js";
+const thinkback = {
+  type: "local-jsx",
+  name: "think-back",
+  description: "Your 2025 Claude Code Year in Review",
+  isEnabled: () => checkStatsigFeatureGate_CACHED_MAY_BE_STALE("tengu_thinkback"),
+  load: () => import("./thinkback.js")
+};
+export default thinkback;