@flowmind/cli 0.3.1 → 0.3.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdullah Faruk Gonullu
+
+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/README.md

@@ -13,6 +13,9 @@ flowmind hooks install
 
 `hooks install` copies the Flowmind skill to Codex and Claude Code and adds session hooks to
 `~/.codex/hooks.json` and `~/.claude/settings.json`. Other hooks in those files stay as they are.
+When the Flowmind Claude Code plugin (`flowmind@flowmind` from `afgonullu/flowmind-skill`) is
+installed and enabled, the plugin provides the skill in Claude Code: `hooks install` writes no
+copy to `~/.claude/skills`, removes an unmodified copy it wrote earlier, and still adds the hooks.
 The hooks run `agent hook` through the absolute paths of the installing Node binary and CLI file,
 because hooks start without your shell profile and a version manager may not put `node` on PATH.
 Codex on Windows gets a PowerShell command (`& '<node>' '<cli>' agent hook --agent codex`).

package/dist/index.js

@@ -3775,16 +3775,16 @@ async function inspect(agent) {
   const file = await statIfPresent(path);
   const marker = await statIfPresent(markerPath);
   if (file && !file.isFile() || marker && !marker.isFile()) {
-    return { state: "unsupported", path, markerPath };
+    return { agent, state: "unsupported", path, markerPath };
   }
-  if (!file) return { state: "absent", path, markerPath };
+  if (!file) return { agent, state: "absent", path, markerPath };
   const contentHash = hash(await readFile3(path, "utf8"));
-  if (!marker) return { state: "unmanaged", path, markerPath, contentHash };
+  if (!marker) return { agent, state: "unmanaged", path, markerPath, contentHash };
   const savedHash = (await readFile3(markerPath, "utf8")).trim();
   if (!/^[a-f0-9]{64}$/.test(savedHash)) {
-    return { state: "unsupported", path, markerPath, contentHash };
+    return { agent, state: "unsupported", path, markerPath, contentHash };
   }
-  return { state: savedHash === contentHash ? "installed" : "modified", path, markerPath, contentHash };
+  return { agent, state: savedHash === contentHash ? "installed" : "modified", path, markerPath, contentHash };
 }
 var FLOWMIND_HOOK = /(?:^flowmind|index\.js') agent hook --agent (?:codex|claude)$/;
 var portablePath = (path) => realpathSync(path).replaceAll("\\", "/");
@@ -3875,6 +3875,50 @@ function withFlowmindHooks(config2, agent) {
 }
 var serialize = (config2) => `${JSON.stringify(config2, null, 2)}
 `;
+var PLUGIN_NAME = "flowmind";
+var PLUGIN_REPOSITORY = "afgonullu/flowmind-skill";
+async function readClaudePluginFile(path) {
+  let text;
+  try {
+    text = await readFile3(path, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+  const parsed = JSON.parse(text);
+  if (!isObject(parsed)) throw new Error(`${path} must contain a JSON object`);
+  return parsed;
+}
+function pluginFrom(installed, marketplaces, enabled) {
+  if (!isObject(installed.plugins)) throw new Error('installed_plugins.json has no "plugins" object');
+  for (const [id, installs] of Object.entries(installed.plugins)) {
+    const [name, marketplace] = id.split("@");
+    if (name !== PLUGIN_NAME || !marketplace || enabled[id] !== true) continue;
+    const entry = marketplaces[marketplace];
+    const source = isObject(entry) ? entry.source : void 0;
+    if (!isObject(source) || source.source !== "github" || typeof source.repo !== "string") continue;
+    if (source.repo.toLowerCase() !== PLUGIN_REPOSITORY) continue;
+    const userInstall = Array.isArray(installs) ? installs.find((install) => isObject(install) && install.scope === "user") : void 0;
+    if (!userInstall) continue;
+    return { id, version: typeof userInstall.version === "string" ? userInstall.version : null };
+  }
+  return null;
+}
+async function flowmindClaudePlugin(claudeSettings) {
+  const pluginsDir = join3(homedir(), ".claude", "plugins");
+  try {
+    const installed = await readClaudePluginFile(join3(pluginsDir, "installed_plugins.json"));
+    const marketplaces = await readClaudePluginFile(join3(pluginsDir, "known_marketplaces.json"));
+    if (!installed || !marketplaces) return null;
+    const enabled = isObject(claudeSettings?.enabledPlugins) ? claudeSettings.enabledPlugins : {};
+    return pluginFrom(installed, marketplaces, enabled);
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    console.warn(`Warning: could not read the Claude Code plugin list in ${pluginsDir} (${reason}); treating the Flowmind plugin as absent.`);
+    return null;
+  }
+}
+var pluginLabel = (plugin) => plugin.version ? `${plugin.id} ${plugin.version}` : plugin.id;
 function selectedAgents(value) {
   if (value === "all" || value === "codex" || value === "claude") return value;
   throw new InvalidArgumentError2("Agent must be codex, claude, or all.");
@@ -3887,14 +3931,19 @@ async function bundledSkill() {
   return readFile3(new URL("./flowmind/SKILL.md", import.meta.url), "utf8");
 }
 var hooksCommand = new Command4("hooks").description("Manage the Flowmind agent skill and session hooks");
-hooksCommand.command("install").description("Install the Flowmind skill and session hooks for Codex and/or Claude Code").option("--agent <agent>", "codex, claude, or all", selectedAgents, "all").option("--force", "Replace an existing edited or unmanaged skill", false).option("--dry-run", "Show writes without changing files", false).action(async (options) => {
+hooksCommand.command("install").description(
+  "Install the Flowmind skill and session hooks for Codex and/or Claude Code. An enabled Flowmind Claude Code plugin provides the skill there instead."
+).option("--agent <agent>", "codex, claude, or all", selectedAgents, "all").option("--force", "Replace an existing edited or unmanaged skill", false).option("--dry-run", "Show writes without changing files", false).action(async (options) => {
   try {
     const content = await bundledSkill();
     const nextHash = hash(content);
     const targets = options.agent === "all" ? agents : [options.agent];
     const inspections = await Promise.all(targets.map(inspect));
     const hookConfigs = await Promise.all(targets.map(readHookConfig));
-    for (const target of inspections) {
+    const claudeIndex = targets.indexOf("claude");
+    const plugin = claudeIndex >= 0 ? await flowmindClaudePlugin(hookConfigs[claudeIndex].current) : null;
+    const copies = inspections.filter((target) => !(plugin && target.agent === "claude"));
+    for (const target of copies) {
       if (target.state === "unsupported") {
         throw new Error(`Unsupported skill or hash file at ${target.path}; no files written.`);
       }
@@ -3902,7 +3951,7 @@ hooksCommand.command("install").description("Install the Flowmind skill and sess
         throw new Error(`Refusing to overwrite ${target.path}; use --force to replace it. No files written.`);
       }
     }
-    for (const target of inspections) {
+    for (const target of copies) {
       if (target.contentHash === nextHash && target.state === "installed") {
         console.log(`Unchanged ${target.path}`);
         continue;
@@ -3922,6 +3971,23 @@ hooksCommand.command("install").description("Install the Flowmind skill and sess
 `, { flag: "w", mode: 420 });
       console.log(`Wrote ${target.markerPath}`);
     }
+    if (plugin) {
+      const copy = inspections[claudeIndex];
+      const reason = `the Flowmind plugin ${pluginLabel(plugin)} provides the skill in Claude Code`;
+      if (copy.state === "installed") {
+        if (options.dryRun) {
+          console.log(`Would remove ${copy.path} and ${copy.markerPath}: ${reason}`);
+        } else {
+          await rm2(copy.path);
+          await rm2(copy.markerPath);
+          console.log(`Removed ${copy.path} and ${copy.markerPath}: ${reason}`);
+        }
+      } else if (copy.state === "absent") {
+        console.log(`Skipped ${copy.path}: ${reason}`);
+      } else {
+        console.log(`Left ${copy.state} ${copy.path}: ${reason}. Remove that copy so the skill loads once.`);
+      }
+    }
     let codexHooksChanged = false;
     for (const [index, agent] of targets.entries()) {
       const config2 = hookConfigs[index];
@@ -3948,8 +4014,20 @@ hooksCommand.command("install").description("Install the Flowmind skill and sess
 hooksCommand.command("status").description("Show installed skills, session hooks, and a read-only legacy Codex copy").action(async () => {
   try {
     const currentHash = hash(await bundledSkill());
+    let plugin = null;
+    try {
+      plugin = await flowmindClaudePlugin((await readHookConfig("claude")).current);
+    } catch {
+      plugin = null;
+    }
     for (const agent of agents) {
       const target = await inspect(agent);
+      if (agent === "claude" && plugin) {
+        console.log(`claude: provided by plugin ${pluginLabel(plugin)}`);
+        const duplicate = target.state === "absent" ? "" : " (duplicate of the plugin)";
+        console.log(`claude copy: ${target.state}${duplicate} ${target.path}`);
+        continue;
+      }
       const update = target.state === "installed" && target.contentHash !== currentHash ? " (update available)" : "";
       console.log(`${agent}: ${target.state}${update} ${target.path}`);
     }
@@ -3997,6 +4075,10 @@ hooksCommand.command("uninstall").description("Remove unmodified Flowmind-manage
         console.log(`Updated ${config2.path}`);
       }
     }
+    const plugin = await flowmindClaudePlugin((await readHookConfig("claude")).current);
+    if (plugin) {
+      console.log(`Left plugin ${pluginLabel(plugin)}; remove it with: claude plugin uninstall ${plugin.id}`);
+    }
   } catch (error) {
     reportError(error);
   }
@@ -5853,7 +5935,7 @@ var shipLogCommand = new Command10("ship-log").description("Read a project ship
 
 // src/index.ts
 var program = new Command11();
-program.name("flowmind").description("Flowmind CLI (also installed as fm)").version("0.3.1").enablePositionalOptions();
+program.name("flowmind").description("Flowmind CLI (also installed as fm)").version("0.3.2").enablePositionalOptions();
 program.addCommand(agentCommand);
 program.addCommand(authCommand);
 program.addCommand(logCommand);

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@flowmind/cli",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Flowmind CLI: log what you and your coding agents ship, with the outcome and the link that proves it. Works with Codex and Claude Code.",
+  "license": "MIT",
   "keywords": [
     "flowmind",
     "cli",