claudescreenfix-hardwicksoftware 2.2.1 → 2.3.1

package/install-hook.cjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+/**
+ * Auto-install Claude hook on npm install
+ * - Creates hook file in ~/.claude/hooks/
+ * - Registers hook in ~/.claude/settings.json (without clobbering existing settings)
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const HOOK_NAME = 'screenfix-loader.js';
+const CLAUDE_DIR = path.join(os.homedir(), '.claude');
+const CLAUDE_HOOKS_DIR = path.join(CLAUDE_DIR, 'hooks');
+const SETTINGS_FILE = path.join(CLAUDE_DIR, 'settings.json');
+
+const HOOK_CONTENT = `#!/usr/bin/env node
+/**
+ * CLAUDE SCREENFIX LOADER HOOK
+ * ============================
+ *
+ * SessionStart hook that loads claudescreenfix-hardwicksoftware
+ * to fix VTE rendering glitches on headless/VNC displays.
+ *
+ * Auto-installed by: npm install claudescreenfix-hardwicksoftware
+ *
+ * Hook Event: SessionStart
+ */
+
+try {
+  const screenfix = require('claudescreenfix-hardwicksoftware');
+  screenfix.install();
+} catch (e) {
+  // screenfix not installed or failed, continue silently
+}
+
+// Hook must output valid JSON for SessionStart
+const input = process.argv[2] || '{}';
+try {
+  const hookEvent = JSON.parse(input);
+  if (hookEvent.type === 'SessionStart') {
+    console.log(JSON.stringify({ result: '' }));
+  }
+} catch (e) {
+  // Not a valid hook call, ignore
+}
+`;
+
+// The hook config to add to settings.json
+const HOOK_CONFIG = {
+  hooks: [{
+    type: 'command',
+    command: 'node ' + path.join(CLAUDE_HOOKS_DIR, HOOK_NAME),
+    timeout: 5
+  }]
+};
+
+function install() {
+  try {
+    // Create dirs if needed
+    if (!fs.existsSync(CLAUDE_DIR)) {
+      fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+    }
+    if (!fs.existsSync(CLAUDE_HOOKS_DIR)) {
+      fs.mkdirSync(CLAUDE_HOOKS_DIR, { recursive: true });
+      console.log('[screenfix] Created ' + CLAUDE_HOOKS_DIR);
+    }
+
+    // Write the hook file
+    const hookPath = path.join(CLAUDE_HOOKS_DIR, HOOK_NAME);
+    fs.writeFileSync(hookPath, HOOK_CONTENT, { mode: 0o755 });
+    console.log('[screenfix] Installed hook to ' + hookPath);
+
+    // Register in settings.json
+    registerHook();
+
+    console.log('[screenfix] Restart Claude Code to activate headless mode fix');
+  } catch (e) {
+    console.error('[screenfix] Failed to install hook:', e.message);
+  }
+}
+
+function registerHook() {
+  let settings = {};
+
+  // Read existing settings
+  if (fs.existsSync(SETTINGS_FILE)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(SETTINGS_FILE, 'utf8'));
+    } catch (e) {
+      console.log('[screenfix] Could not parse settings.json, creating new');
+    }
+  }
+
+  // Ensure hooks object exists
+  if (!settings.hooks) {
+    settings.hooks = {};
+  }
+
+  // Ensure SessionStart array exists
+  if (!settings.hooks.SessionStart) {
+    settings.hooks.SessionStart = [];
+  }
+
+  // Check if our hook is already registered
+  const alreadyRegistered = settings.hooks.SessionStart.some(h =>
+    h.hooks && h.hooks.some(hh => hh.command && hh.command.includes('screenfix-loader'))
+  );
+
+  if (alreadyRegistered) {
+    console.log('[screenfix] Hook already registered in settings.json');
+    return;
+  }
+
+  // Add our hook to the BEGINNING so it loads first
+  settings.hooks.SessionStart.unshift(HOOK_CONFIG);
+
+  // Write back settings
+  fs.writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2));
+  console.log('[screenfix] Registered hook in settings.json');
+}
+
+// Run install
+install();

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "claudescreenfix-hardwicksoftware",
-  "version": "2.2.1",
-  "description": "fixes scroll glitch + VNC/headless rendering in claude code cli - strips BG colors that break VTE on Xvfb",
+  "version": "2.3.1",
+  "description": "fixes scroll glitch + VNC/headless rendering in claude code cli - auto-installs hook, strips BG colors on Xvfb",
   "main": "index.cjs",
   "bin": {
     "claude-fixed": "./bin/claude-fixed.js"
   },
-  "scripts": {},
+  "scripts": {
+    "postinstall": "node install-hook.cjs"
+  },
   "keywords": [
     "claude",
     "terminal",
@@ -32,6 +34,7 @@
   "files": [
     "index.cjs",
     "loader.cjs",
+    "install-hook.cjs",
     "bin/",
     "README.md",
     "LICENSE"