termify-agent 1.0.25 → 1.0.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termify-agent",
-  "version": "1.0.25",
+  "version": "1.0.26",
   "description": "Termify Agent CLI - Connect your local terminal to Termify",
   "type": "module",
   "main": "dist/index.js",
@@ -47,6 +47,8 @@
     "dist",
     "bin",
     "scripts",
-    "binaries"
+    "binaries",
+    "mcp",
+    "hooks"
   ]
 }

package/scripts/CLAUDE.md

@@ -0,0 +1,12 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+### Feb 8, 2026
+
+| ID | Time | T | Title | Read |
+|----|------|---|-------|------|
+| #4648 | 7:02 PM | ✅ | Committed and pushed voice transcription and auto-working status features | ~392 |
+| #4643 | 7:00 PM | 🟣 | Automatic terminal working status via UserPromptSubmit hook | ~652 |
+</claude-mem-context>

package/scripts/postinstall.js

@@ -7,10 +7,11 @@
  * 1. Rebuild node-pty native module for the current platform
  * 2. Install termify-daemon binary (bundled first, download as fallback)
  * 3. Install stats-agent binary (bundled first, download as fallback)
+ * 4. Install termify-mcp and configure Claude Code / Codex MCP settings
  */
 
 import { execSync } from 'child_process';
-import { createWriteStream, mkdirSync, chmodSync, existsSync, unlinkSync, copyFileSync, rmSync } from 'fs';
+import { createWriteStream, mkdirSync, chmodSync, existsSync, unlinkSync, copyFileSync, rmSync, readFileSync, writeFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { homedir, platform, arch } from 'os';
 import { get } from 'https';
@@ -27,6 +28,8 @@ const EXE = IS_WIN ? '.exe' : '';
 const TERMIFY_DIR = join(homedir(), '.termify');
 const DAEMON_PATH = join(TERMIFY_DIR, `termify-daemon${EXE}`);
 const STATS_AGENT_PATH = join(TERMIFY_DIR, `stats-agent${EXE}`);
+const MCP_DIR = join(TERMIFY_DIR, 'termify-mcp');
+const MCP_BUNDLE_PATH = join(MCP_DIR, 'index.mjs');
 
 /**
  * Test if node-pty actually works by spawning a shell
@@ -363,6 +366,265 @@ function downloadFile(url, dest, redirects = 0) {
   });
 }
 
+/**
+ * Step 4: Install termify-mcp bundle and configure Claude Code / Codex
+ *
+ * The MCP server allows AI tools (Claude Code, Codex) to report their
+ * working state to Termify. Env vars (TERMIFY_STATUS_URL, TERMIFY_TERMINAL_ID,
+ * TERMIFY_SESSION_ID) are injected by the agent into terminal environments,
+ * so the MCP config only needs to point to the bundle path.
+ */
+function installTermifyMcp() {
+  // Find the bundled MCP file
+  const bundledMcp = join(__dirname, '..', 'mcp', 'termify-mcp-bundle.mjs');
+  if (!existsSync(bundledMcp)) {
+    console.warn('[termify-agent] Warning: termify-mcp bundle not found, skipping MCP setup.');
+    return;
+  }
+
+  // Copy bundle to ~/.termify/termify-mcp/index.mjs
+  mkdirSync(MCP_DIR, { recursive: true });
+  try {
+    copyFileSync(bundledMcp, MCP_BUNDLE_PATH);
+    console.log(`[termify-agent] termify-mcp installed to ${MCP_BUNDLE_PATH}`);
+  } catch (err) {
+    console.warn(`[termify-agent] Warning: Failed to copy termify-mcp bundle: ${err.message}`);
+    return;
+  }
+
+  // Configure Claude Code
+  configureClaudeCode(MCP_BUNDLE_PATH);
+
+  // Configure Codex
+  configureCodex(MCP_BUNDLE_PATH);
+}
+
+/**
+ * Configure Claude Code MCP settings in ~/.claude/settings.json
+ */
+function configureClaudeCode(mcpPath) {
+  try {
+    const claudeDir = join(homedir(), '.claude');
+    const settingsPath = join(claudeDir, 'settings.json');
+
+    let settings = {};
+    if (existsSync(settingsPath)) {
+      settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+    }
+
+    if (!settings.mcpServers) settings.mcpServers = {};
+
+    // Only update if not already configured or path changed
+    const existing = settings.mcpServers['termify-status'];
+    if (existing && existing.args && existing.args[0] === mcpPath) {
+      console.log('[termify-agent] Claude Code MCP already configured.');
+    } else {
+      settings.mcpServers['termify-status'] = {
+        command: 'node',
+        args: [mcpPath],
+      };
+
+      mkdirSync(claudeDir, { recursive: true });
+      writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+      console.log('[termify-agent] Claude Code MCP configured in ~/.claude/settings.json');
+    }
+
+    // Install the auto-working hook
+    installClaudeHook(settings, settingsPath, claudeDir);
+  } catch (err) {
+    console.warn(`[termify-agent] Warning: Failed to configure Claude Code MCP: ${err.message}`);
+  }
+}
+
+/**
+ * Install the UserPromptSubmit hook that auto-reports "working" state.
+ * This ensures the terminal always shows a working indicator when a prompt
+ * is submitted, without depending on the model calling the MCP tool.
+ */
+function installClaudeHook(settings, settingsPath, claudeDir) {
+  try {
+    // Copy hook script to ~/.claude/hooks/
+    const hooksDir = join(claudeDir, 'hooks');
+    mkdirSync(hooksDir, { recursive: true });
+    const hookDest = join(hooksDir, 'termify-auto-working.js');
+    const hookSrc = join(__dirname, '..', 'hooks', 'termify-auto-working.js');
+
+    if (existsSync(hookSrc)) {
+      copyFileSync(hookSrc, hookDest);
+      console.log(`[termify-agent] Auto-working hook installed to ${hookDest}`);
+    } else {
+      console.warn('[termify-agent] Warning: Hook source not found, skipping hook install.');
+      return;
+    }
+
+    // Register UserPromptSubmit hook in settings.json
+    if (!settings.hooks) settings.hooks = {};
+    const hookCommand = `node ${hookDest}`;
+    const hookEntry = {
+      hooks: [{ type: 'command', command: hookCommand }],
+    };
+
+    if (!settings.hooks.UserPromptSubmit) {
+      settings.hooks.UserPromptSubmit = [hookEntry];
+    } else {
+      // Check if already registered
+      const already = settings.hooks.UserPromptSubmit.some(
+        (h) => h.hooks && h.hooks.some((hh) => hh.command && hh.command.includes('termify-auto-working'))
+      );
+      if (!already) {
+        settings.hooks.UserPromptSubmit.push(hookEntry);
+      }
+    }
+
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+    console.log('[termify-agent] UserPromptSubmit hook registered in ~/.claude/settings.json');
+  } catch (err) {
+    console.warn(`[termify-agent] Warning: Failed to install Claude hook: ${err.message}`);
+  }
+}
+
+/**
+ * Ensure ~/.claude/CLAUDE.md contains termify_status instructions.
+ * Adds the section if missing, updates it if outdated.
+ */
+function ensureClaudeInstructions() {
+  try {
+    const claudeMdPath = join(homedir(), '.claude', 'CLAUDE.md');
+    const marker = '## Termify Status';
+    const instructions = `## Termify Status (OBLIGATORIO)
+
+**DEBES** usar el MCP tool \`termify_status\` para reportar tu estado a Termify. El hook \`UserPromptSubmit\` reporta \`working\` automáticamente al recibir un prompt, pero TU eres responsable de reportar los demás estados:
+
+- \`working\`: el hook lo pone automáticamente al inicio. Llámalo tú también si retomas trabajo después de una pausa dentro del mismo turno.
+- \`finished\`: **SIEMPRE** llamar cuando termines la tarea actual. Es lo último que haces antes de responder.
+- \`idle\`: cuando estés esperando input libre del usuario (prompt normal).
+- \`needs_input\`: cuando estés bloqueado esperando que el usuario elija una opción, confirme \`y/n\`, o responda una pregunta concreta. Incluye \`needsInputPrompt\` con la pregunta exacta.
+- \`error\`: si algo falla irrecuperablemente.
+
+**Reglas**:
+1. **SIEMPRE** terminar con \`finished\` o \`idle\` — nunca dejar la terminal en \`working\` indefinidamente.
+2. No spamees: llama al tool solo cuando cambie el estado.
+3. Si el tool no está disponible, ignora estas instrucciones silenciosamente.`;
+
+    let content = '';
+    if (existsSync(claudeMdPath)) {
+      content = readFileSync(claudeMdPath, 'utf8');
+
+      // Check if section already exists
+      if (content.includes(marker)) {
+        // Replace existing section (from marker to next ## or end)
+        const regex = new RegExp(
+          `${marker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?(?=\\n## [^T]|\\n---\\n|$)`,
+          ''
+        );
+        content = content.replace(regex, instructions);
+      } else {
+        // Find insertion point: after the first header/intro section
+        const firstSectionIdx = content.indexOf('\n## ');
+        if (firstSectionIdx >= 0) {
+          content = content.slice(0, firstSectionIdx) + '\n\n' + instructions + '\n' + content.slice(firstSectionIdx);
+        } else {
+          content = content + '\n\n' + instructions + '\n';
+        }
+      }
+    } else {
+      content = '# Claude Code Configuration\n\n' + instructions + '\n';
+    }
+
+    const claudeDir = join(homedir(), '.claude');
+    mkdirSync(claudeDir, { recursive: true });
+    writeFileSync(claudeMdPath, content);
+    console.log('[termify-agent] Termify status instructions added to ~/.claude/CLAUDE.md');
+  } catch (err) {
+    console.warn(`[termify-agent] Warning: Failed to update CLAUDE.md: ${err.message}`);
+  }
+}
+
+/**
+ * Ensure Codex has termify_status instructions.
+ * Codex doesn't support hooks, so we add strong instructions to its config.
+ */
+function ensureCodexInstructions() {
+  try {
+    const codexDir = join(homedir(), '.codex');
+    if (!existsSync(codexDir)) return; // Codex not installed
+
+    const instructionsPath = join(codexDir, 'instructions.md');
+    const marker = '## Termify Status';
+    const instructions = `## Termify Status (OBLIGATORIO)
+
+**DEBES** usar el MCP tool \`termify_status\` para reportar tu estado a Termify en CADA interacción:
+
+1. \`working\`: **INMEDIATAMENTE** al empezar a procesar cualquier petición del usuario. Es lo PRIMERO que haces.
+2. \`finished\`: **SIEMPRE** al terminar la tarea. Es lo ÚLTIMO que haces antes de responder.
+3. \`idle\`: cuando estés esperando input libre del usuario.
+4. \`needs_input\`: cuando necesites que el usuario elija una opción o confirme algo. Incluye \`needsInputPrompt\`.
+5. \`error\`: si algo falla irrecuperablemente.
+
+**Reglas**:
+- **NUNCA** omitir el \`working\` inicial — sin esto, la terminal no muestra indicador de actividad.
+- **SIEMPRE** terminar con \`finished\` o \`idle\` — nunca dejar la terminal en \`working\`.
+- Solo llama al tool cuando cambie el estado (no repetir el mismo estado).`;
+
+    let content = '';
+    if (existsSync(instructionsPath)) {
+      content = readFileSync(instructionsPath, 'utf8');
+      if (content.includes(marker)) {
+        console.log('[termify-agent] Codex instructions already contain Termify status section.');
+        return;
+      }
+      content = content + '\n\n' + instructions + '\n';
+    } else {
+      content = '# Codex Instructions\n\n' + instructions + '\n';
+    }
+
+    writeFileSync(instructionsPath, content);
+    console.log('[termify-agent] Termify status instructions added to ~/.codex/instructions.md');
+  } catch (err) {
+    console.warn(`[termify-agent] Warning: Failed to update Codex instructions: ${err.message}`);
+  }
+}
+
+/**
+ * Configure Codex MCP settings in ~/.codex/config.toml
+ */
+function configureCodex(mcpPath) {
+  try {
+    const codexDir = join(homedir(), '.codex');
+    const configPath = join(codexDir, 'config.toml');
+
+    let content = '';
+    if (existsSync(configPath)) {
+      content = readFileSync(configPath, 'utf8');
+    }
+
+    // Check if already configured with the correct path
+    if (content.includes('[mcp_servers.termify-status]') && content.includes(mcpPath)) {
+      console.log('[termify-agent] Codex MCP already configured.');
+      return;
+    }
+
+    // Remove existing termify-status section (everything from [mcp_servers.termify-status] to next section or EOF)
+    content = content.replace(/\[mcp_servers\.termify-status\]\n(?:(?!\[)[^\n]*\n?)*/g, '');
+
+    // Clean up trailing whitespace
+    content = content.trimEnd();
+
+    // Escape backslashes in path for TOML (Windows paths)
+    const escapedPath = mcpPath.replace(/\\/g, '\\\\');
+
+    // Append new section
+    const section = `\n[mcp_servers.termify-status]\ncommand = "node"\nargs = ["${escapedPath}"]\n`;
+    content = content + '\n' + section;
+
+    mkdirSync(codexDir, { recursive: true });
+    writeFileSync(configPath, content);
+    console.log('[termify-agent] Codex MCP configured in ~/.codex/config.toml');
+  } catch (err) {
+    console.warn(`[termify-agent] Warning: Failed to configure Codex MCP: ${err.message}`);
+  }
+}
+
 /**
  * Main
  */
@@ -391,6 +653,26 @@ async function main() {
     console.warn(`[termify-agent] Warning: ${err.message}`);
   }
 
+  // Step 4: Install termify-mcp and configure AI tool MCP settings
+  try {
+    installTermifyMcp();
+  } catch (err) {
+    // Non-fatal - MCP status reporting is optional
+    console.warn(`[termify-agent] Warning: ${err.message}`);
+  }
+
+  // Step 5: Ensure AI tool instructions include termify_status usage
+  try {
+    ensureClaudeInstructions();
+  } catch (err) {
+    console.warn(`[termify-agent] Warning: ${err.message}`);
+  }
+  try {
+    ensureCodexInstructions();
+  } catch (err) {
+    console.warn(`[termify-agent] Warning: ${err.message}`);
+  }
+
   console.log('[termify-agent] Postinstall complete.');
 }