Initial commit

src/commands/terminalSetup.ts

@@ -0,0 +1,143 @@
+import { Command } from '../commands.js'
+import { EOL, platform, homedir } from 'os'
+import { execFileNoThrow } from '../utils/execFileNoThrow.js'
+import chalk from 'chalk'
+import { getTheme } from '../utils/theme.js'
+import { env } from '../utils/env.js'
+import { getGlobalConfig, saveGlobalConfig } from '../utils/config.js'
+import { markProjectOnboardingComplete } from '../ProjectOnboarding.js'
+import { readFileSync, writeFileSync } from 'fs'
+import { join } from 'path'
+import { safeParseJSON } from '../utils/json.js'
+import { logError } from '../utils/log.js'
+
+const terminalSetup: Command = {
+  type: 'local',
+  name: 'terminal-setup',
+  userFacingName() {
+    return 'terminal-setup'
+  },
+  description:
+    'Install Shift+Enter key binding for newlines (iTerm2 and VSCode only)',
+  isEnabled:
+    (platform() === 'darwin' && env.terminal === 'iTerm.app') ||
+    env.terminal === 'vscode',
+  isHidden: false,
+  async call() {
+    let result = ''
+
+    switch (env.terminal) {
+      case 'iTerm.app':
+        result = await installBindingsForITerm2()
+        break
+      case 'vscode':
+        result = installBindingsForVSCodeTerminal()
+        break
+    }
+
+    // Update global config to indicate Shift+Enter key binding is installed
+    const config = getGlobalConfig()
+    config.shiftEnterKeyBindingInstalled = true
+    saveGlobalConfig(config)
+
+    // Mark onboarding as complete
+    markProjectOnboardingComplete()
+
+    return result
+  },
+}
+
+export function isShiftEnterKeyBindingInstalled(): boolean {
+  return getGlobalConfig().shiftEnterKeyBindingInstalled === true
+}
+
+export default terminalSetup
+
+async function installBindingsForITerm2(): Promise<string> {
+  const { code } = await execFileNoThrow('defaults', [
+    'write',
+    'com.googlecode.iterm2',
+    'GlobalKeyMap',
+    '-dict-add',
+    '0xd-0x20000-0x24',
+    `<dict>
+      <key>Text</key>
+      <string>\\n</string>
+      <key>Action</key>
+      <integer>12</integer>
+      <key>Version</key>
+      <integer>1</integer>
+      <key>Keycode</key>
+      <integer>13</integer>
+      <key>Modifiers</key>
+      <integer>131072</integer>
+    </dict>`,
+  ])
+
+  if (code !== 0) {
+    throw new Error('Failed to install iTerm2 Shift+Enter key binding')
+  }
+
+  return `${chalk.hex(getTheme().success)(
+    'Installed iTerm2 Shift+Enter key binding',
+  )}${EOL}${chalk.dim('See iTerm2 → Preferences → Keys')}${EOL}`
+}
+
+type VSCodeKeybinding = {
+  key: string
+  command: string
+  args: { text: string }
+  when: string
+}
+
+function installBindingsForVSCodeTerminal(): string {
+  const vscodeKeybindingsPath = join(
+    homedir(),
+    platform() === 'win32'
+      ? join('AppData', 'Roaming', 'Code', 'User')
+      : platform() === 'darwin'
+        ? join('Library', 'Application Support', 'Code', 'User')
+        : join('.config', 'Code', 'User'),
+    'keybindings.json',
+  )
+
+  try {
+    const content = readFileSync(vscodeKeybindingsPath, 'utf-8')
+    const keybindings: VSCodeKeybinding[] =
+      (safeParseJSON(content) as VSCodeKeybinding[]) ?? []
+
+    // Check if keybinding already exists
+    const existingBinding = keybindings.find(
+      binding =>
+        binding.key === 'shift+enter' &&
+        binding.command === 'workbench.action.terminal.sendSequence' &&
+        binding.when === 'terminalFocus',
+    )
+    if (existingBinding) {
+      return `${chalk.hex(getTheme().warning)(
+        'Found existing VSCode terminal Shift+Enter key binding. Remove it to continue.',
+      )}${EOL}${chalk.dim(`See ${vscodeKeybindingsPath}`)}${EOL}`
+    }
+
+    // Add the keybinding
+    keybindings.push({
+      key: 'shift+enter',
+      command: 'workbench.action.terminal.sendSequence',
+      args: { text: '\\\r\n' },
+      when: 'terminalFocus',
+    })
+
+    writeFileSync(
+      vscodeKeybindingsPath,
+      JSON.stringify(keybindings, null, 4),
+      'utf-8',
+    )
+
+    return `${chalk.hex(getTheme().success)(
+      'Installed VSCode terminal Shift+Enter key binding',
+    )}${EOL}${chalk.dim(`See ${vscodeKeybindingsPath}`)}${EOL}`
+  } catch (e) {
+    logError(e)
+    throw new Error('Failed to install VSCode terminal Shift+Enter key binding')
+  }
+}