@devness/useai-cli 0.3.4 → 0.3.6

package/dist/index.js

@@ -395,7 +395,7 @@ import chalk6 from "chalk";
 
 // src/services/tools.ts
 import { execSync } from "child_process";
-import { existsSync as existsSync4, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, unlinkSync } from "fs";
 import { dirname, join as join2 } from "path";
 import { homedir as homedir2 } from "os";
 import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
@@ -589,6 +589,65 @@ function removeYaml(configPath) {
     writeYamlFile(configPath, config);
   }
 }
+var INSTRUCTIONS_START = "<!-- useai:start -->";
+var INSTRUCTIONS_END = "<!-- useai:end -->";
+var USEAI_INSTRUCTIONS = [
+  "## UseAI Session Tracking",
+  "- At the START of every conversation, call `useai_session_start` with the appropriate task_type.",
+  "- For LONG sessions (15+ min), call `useai_heartbeat` periodically.",
+  "- At the END of every conversation, call `useai_session_end` with languages used, files_touched_count, and milestones (generic descriptions only \u2014 no project names, file paths, or company names)."
+].join("\n");
+var USEAI_INSTRUCTIONS_BLOCK = `${INSTRUCTIONS_START}
+${USEAI_INSTRUCTIONS}
+${INSTRUCTIONS_END}`;
+function hasInstructionsBlock(filePath) {
+  if (!existsSync4(filePath)) return false;
+  try {
+    return readFileSync2(filePath, "utf-8").includes(INSTRUCTIONS_START);
+  } catch {
+    return false;
+  }
+}
+function injectInstructions(config) {
+  mkdirSync2(dirname(config.path), { recursive: true });
+  if (config.method === "create") {
+    writeFileSync2(config.path, USEAI_INSTRUCTIONS + "\n");
+    return;
+  }
+  if (hasInstructionsBlock(config.path)) return;
+  let existing = "";
+  if (existsSync4(config.path)) {
+    existing = readFileSync2(config.path, "utf-8");
+  }
+  const separator = existing && !existing.endsWith("\n") ? "\n\n" : existing ? "\n" : "";
+  writeFileSync2(config.path, existing + separator + USEAI_INSTRUCTIONS_BLOCK + "\n");
+}
+function removeInstructions(config) {
+  if (config.method === "create") {
+    if (existsSync4(config.path)) {
+      try {
+        unlinkSync(config.path);
+      } catch {
+      }
+    }
+    return;
+  }
+  if (!existsSync4(config.path)) return;
+  try {
+    const content = readFileSync2(config.path, "utf-8");
+    const escaped = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const regex = new RegExp(
+      `\\n?${escaped(INSTRUCTIONS_START)}[\\s\\S]*?${escaped(INSTRUCTIONS_END)}\\n?`
+    );
+    const cleaned = content.replace(regex, "").trim();
+    if (cleaned) {
+      writeFileSync2(config.path, cleaned + "\n");
+    } else {
+      unlinkSync(config.path);
+    }
+  } catch {
+  }
+}
 var formatHandlers = {
   standard: { isConfigured: isConfiguredStandard, install: installStandard, remove: removeStandard },
   vscode: { isConfigured: isConfiguredVscode, install: installVscode, remove: removeVscode },
@@ -605,8 +664,14 @@ function createTool(def) {
     getConfigPath: () => def.configPath,
     detect: def.detect,
     isConfigured: () => handler.isConfigured(def.configPath),
-    install: () => handler.install(def.configPath),
-    remove: () => handler.remove(def.configPath)
+    install: () => {
+      handler.install(def.configPath);
+      if (def.instructions) injectInstructions(def.instructions);
+    },
+    remove: () => {
+      handler.remove(def.configPath);
+      if (def.instructions) removeInstructions(def.instructions);
+    }
   };
 }
 var appSupport = join2(home, "Library", "Application Support");
@@ -637,14 +702,8 @@ var AI_TOOLS = [
     name: "Claude Code",
     configFormat: "standard",
     configPath: join2(home, ".claude.json"),
-    detect: () => hasBinary("claude") || existsSync4(join2(home, ".claude.json"))
-  }),
-  createTool({
-    id: "claude-desktop",
-    name: "Claude Desktop",
-    configFormat: "standard",
-    configPath: join2(appSupport, "Claude", "claude_desktop_config.json"),
-    detect: () => existsSync4(join2(appSupport, "Claude")) || existsSync4("/Applications/Claude.app")
+    detect: () => hasBinary("claude") || existsSync4(join2(home, ".claude.json")),
+    instructions: { method: "append", path: join2(home, ".claude", "CLAUDE.md") }
   }),
   createTool({
     id: "cursor",
@@ -658,28 +717,32 @@ var AI_TOOLS = [
     name: "Windsurf",
     configFormat: "standard",
     configPath: join2(home, ".codeium", "windsurf", "mcp_config.json"),
-    detect: () => existsSync4(join2(home, ".codeium", "windsurf"))
+    detect: () => existsSync4(join2(home, ".codeium", "windsurf")),
+    instructions: { method: "append", path: join2(home, ".codeium", "windsurf", "memories", "global_rules.md") }
   }),
   createTool({
     id: "vscode",
     name: "VS Code",
     configFormat: "vscode",
     configPath: join2(appSupport, "Code", "User", "mcp.json"),
-    detect: () => existsSync4(join2(appSupport, "Code"))
+    detect: () => existsSync4(join2(appSupport, "Code")),
+    instructions: { method: "create", path: join2(appSupport, "Code", "User", "prompts", "useai.instructions.md") }
   }),
   createTool({
     id: "vscode-insiders",
     name: "VS Code Insiders",
     configFormat: "vscode",
     configPath: join2(appSupport, "Code - Insiders", "User", "mcp.json"),
-    detect: () => existsSync4(join2(appSupport, "Code - Insiders"))
+    detect: () => existsSync4(join2(appSupport, "Code - Insiders")),
+    instructions: { method: "create", path: join2(appSupport, "Code - Insiders", "User", "prompts", "useai.instructions.md") }
   }),
   createTool({
     id: "gemini-cli",
     name: "Gemini CLI",
     configFormat: "standard",
     configPath: join2(home, ".gemini", "settings.json"),
-    detect: () => hasBinary("gemini")
+    detect: () => hasBinary("gemini"),
+    instructions: { method: "append", path: join2(home, ".gemini", "GEMINI.md") }
   }),
   createTool({
     id: "zed",
@@ -703,7 +766,8 @@ var AI_TOOLS = [
     ),
     detect: () => existsSync4(
       join2(appSupport, "Code", "User", "globalStorage", "saoudrizwan.claude-dev")
-    )
+    ),
+    instructions: { method: "create", path: join2(home, "Documents", "Cline", "Rules", "useai.md") }
   }),
   createTool({
     id: "roo-code",
@@ -720,7 +784,8 @@ var AI_TOOLS = [
     ),
     detect: () => existsSync4(
       join2(appSupport, "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline")
-    )
+    ),
+    instructions: { method: "create", path: join2(home, ".roo", "rules", "useai.md") }
   }),
   createTool({
     id: "amazon-q-cli",
@@ -741,21 +806,24 @@ var AI_TOOLS = [
     name: "Codex",
     configFormat: "toml",
     configPath: join2(home, ".codex", "config.toml"),
-    detect: () => hasBinary("codex") || existsSync4(join2(home, ".codex")) || existsSync4("/Applications/Codex.app")
+    detect: () => hasBinary("codex") || existsSync4(join2(home, ".codex")) || existsSync4("/Applications/Codex.app"),
+    instructions: { method: "append", path: join2(home, ".codex", "AGENTS.md") }
   }),
   createTool({
     id: "goose",
     name: "Goose",
     configFormat: "yaml",
     configPath: join2(home, ".config", "goose", "config.yaml"),
-    detect: () => existsSync4(join2(home, ".config", "goose"))
+    detect: () => existsSync4(join2(home, ".config", "goose")),
+    instructions: { method: "append", path: join2(home, ".config", "goose", ".goosehints") }
   }),
   createTool({
     id: "opencode",
     name: "OpenCode",
     configFormat: "standard",
     configPath: join2(home, ".config", "opencode", "opencode.json"),
-    detect: () => hasBinary("opencode") || existsSync4(join2(home, ".config", "opencode"))
+    detect: () => hasBinary("opencode") || existsSync4(join2(home, ".config", "opencode")),
+    instructions: { method: "append", path: join2(home, ".config", "opencode", "AGENTS.md") }
   }),
   createTool({
     id: "junie",
@@ -796,17 +864,16 @@ function showStatus(tools) {
 }
 async function installFlow(tools, autoYes, explicit) {
   if (explicit) {
-    const toInstall2 = tools.filter((t) => !t.isConfigured());
-    const alreadyDone = tools.filter((t) => t.isConfigured());
-    for (const tool of alreadyDone) {
-      console.log(info(`${tool.name} is already configured.`));
-    }
-    if (toInstall2.length === 0) return;
     console.log();
-    for (const tool of toInstall2) {
+    for (const tool of tools) {
       try {
+        const wasConfigured = tool.isConfigured();
         tool.install();
-        console.log(success(`\u2713 ${tool.name.padEnd(18)} \u2192 ${chalk6.dim(shortenPath(tool.getConfigPath()))}`));
+        if (wasConfigured) {
+          console.log(success(`\u2713 ${tool.name.padEnd(18)}   ${chalk6.dim("(updated)")}`));
+        } else {
+          console.log(success(`\u2713 ${tool.name.padEnd(18)} \u2192 ${chalk6.dim(shortenPath(tool.getConfigPath()))}`));
+        }
       } catch (err) {
         console.log(error(`\u2717 ${tool.name.padEnd(18)} \u2014 ${err.message}`));
       }
@@ -870,6 +937,12 @@ async function installFlow(tools, autoYes, explicit) {
       console.log(error(`\u2717 ${tool.name.padEnd(18)} \u2014 ${err.message}`));
     }
   }
+  for (const tool of alreadyConfigured) {
+    try {
+      tool.install();
+    } catch {
+    }
+  }
   console.log(`
   Done! UseAI MCP server configured in ${chalk6.bold(String(toInstall.length))} tool${toInstall.length === 1 ? "" : "s"}.
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devness/useai-cli",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "CLI tool for useai.dev — stats, sync, publish your AI development workflow",
   "author": "nabeelkausari",
   "license": "MIT",