@devness/useai-cli 0.3.6 → 0.3.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 useai.dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -400,6 +400,12 @@ import { dirname, join as join2 } from "path";
 import { homedir as homedir2 } from "os";
 import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+var USEAI_INSTRUCTIONS_TEXT = [
+  "## 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 MCP_ENTRY = {
   command: "npx",
   args: ["-y", "@devness/useai"]
@@ -671,7 +677,8 @@ function createTool(def) {
     remove: () => {
       handler.remove(def.configPath);
       if (def.instructions) removeInstructions(def.instructions);
-    }
+    },
+    getManualHint: () => def.instructions ? null : def.manualHint ?? null
   };
 }
 var appSupport = join2(home, "Library", "Application Support");
@@ -710,7 +717,8 @@ var AI_TOOLS = [
     name: "Cursor",
     configFormat: "standard",
     configPath: join2(home, ".cursor", "mcp.json"),
-    detect: () => existsSync4(join2(home, ".cursor"))
+    detect: () => existsSync4(join2(home, ".cursor")),
+    manualHint: "Open Cursor Settings \u2192 Rules \u2192 User Rules and paste the instructions below."
   }),
   createTool({
     id: "windsurf",
@@ -749,7 +757,8 @@ var AI_TOOLS = [
     name: "Zed",
     configFormat: "zed",
     configPath: join2(appSupport, "Zed", "settings.json"),
-    detect: () => existsSync4(join2(appSupport, "Zed"))
+    detect: () => existsSync4(join2(appSupport, "Zed")),
+    manualHint: "Open Rules Library (\u2318\u2325L) \u2192 click + \u2192 paste the instructions below."
   }),
   createTool({
     id: "cline",
@@ -792,14 +801,16 @@ var AI_TOOLS = [
     name: "Amazon Q CLI",
     configFormat: "standard",
     configPath: join2(home, ".aws", "amazonq", "mcp.json"),
-    detect: () => hasBinary("q") || existsSync4(join2(home, ".aws", "amazonq"))
+    detect: () => hasBinary("q") || existsSync4(join2(home, ".aws", "amazonq")),
+    manualHint: "Create .amazonq/rules/useai.md in your project root with the instructions below."
   }),
   createTool({
     id: "amazon-q-ide",
     name: "Amazon Q IDE",
     configFormat: "standard",
     configPath: join2(home, ".aws", "amazonq", "default.json"),
-    detect: () => existsSync4(join2(home, ".amazonq")) || existsSync4(join2(home, ".aws", "amazonq"))
+    detect: () => existsSync4(join2(home, ".amazonq")) || existsSync4(join2(home, ".aws", "amazonq")),
+    manualHint: "Create .amazonq/rules/useai.md in your project root with the instructions below."
   }),
   createTool({
     id: "codex",
@@ -830,7 +841,8 @@ var AI_TOOLS = [
     name: "Junie",
     configFormat: "standard",
     configPath: join2(home, ".junie", "mcp", "mcp.json"),
-    detect: () => existsSync4(join2(home, ".junie"))
+    detect: () => existsSync4(join2(home, ".junie")),
+    manualHint: "Add the instructions below to .junie/guidelines.md in your project root."
   })
 ];
 
@@ -839,6 +851,21 @@ function shortenPath(p) {
   const home2 = process.env["HOME"] ?? "";
   return home2 && p.startsWith(home2) ? p.replace(home2, "~") : p;
 }
+function showManualHints(installedTools) {
+  const hints = installedTools.map((t) => ({ name: t.name, hint: t.getManualHint() })).filter((h) => h.hint !== null);
+  if (hints.length === 0) return;
+  console.log(chalk6.yellow(`
+  \u26A0 Manual setup needed for ${hints.length} tool${hints.length === 1 ? "" : "s"}:
+`));
+  for (const { name, hint } of hints) {
+    console.log(`  ${chalk6.bold(name)}: ${hint}`);
+  }
+  console.log(chalk6.dim("\n  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"));
+  for (const line of USEAI_INSTRUCTIONS_TEXT.split("\n")) {
+    console.log(chalk6.dim("  \u2502 ") + line);
+  }
+  console.log(chalk6.dim("  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n"));
+}
 function showStatus(tools) {
   console.log(header("AI Tool MCP Status"));
   const rows = [];
@@ -878,6 +905,7 @@ async function installFlow(tools, autoYes, explicit) {
         console.log(error(`\u2717 ${tool.name.padEnd(18)} \u2014 ${err.message}`));
       }
     }
+    showManualHints(tools);
     console.log();
     return;
   }
@@ -943,6 +971,7 @@ async function installFlow(tools, autoYes, explicit) {
     } catch {
     }
   }
+  showManualHints([...toInstall, ...alreadyConfigured]);
   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.6",
+  "version": "0.3.7",
   "description": "CLI tool for useai.dev — stats, sync, publish your AI development workflow",
   "author": "nabeelkausari",
   "license": "MIT",
@@ -14,14 +14,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "dev": "tsc --watch",
-    "bundle": "tsup src/index.ts --format esm --target node18 --no-splitting",
-    "prepublishOnly": "pnpm run bundle",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
-  },
   "dependencies": {
     "@inquirer/prompts": "^8.2.1",
     "chalk": "^5.4.1",
@@ -31,9 +23,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.4",
-    "@useai/shared": "workspace:*",
     "tsup": "^8.0.0",
-    "typescript": "^5.7.3"
+    "typescript": "^5.7.3",
+    "@useai/shared": "0.2.0"
   },
   "repository": {
     "type": "git",
@@ -42,5 +34,12 @@
   "homepage": "https://useai.dev",
   "engines": {
     "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "bundle": "tsup src/index.ts --format esm --target node18 --no-splitting",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
   }
-}
+}