@paradigma-inc/flywheel 0.1.53 → 0.1.72

package/skills/flywheel-tree/SKILL.md

@@ -17,7 +17,7 @@ This skill uses one local wrapper command (selector -> MCP resolve/get_node_tree
 This skill supports both Flywheel install modes, with an MCP-first execution path:
 
 - **`--mode mcp` install**: preferred for this skill because `scripts/render_tree_via_mcp.py` resolves and calls MCP directly.
-- **`--mode cli` install**: `setup --mode cli` configures runtime credentials for CLI routing; prerequisite for bare-binary routing is `npm install -g @paradigma-inc/flywheel`. This skill's wrapper still reads through MCP, so keep MCP wiring available for the host that runs the script.
+- **`--mode cli` install**: `setup --mode cli` configures runtime credentials for CLI routing; prerequisite for bare-binary routing is the curl installer with `--mode cli` or the managed-prefix npm install recipe from the README. This skill's wrapper still reads through MCP, so keep MCP wiring available for the host that runs the script.
 
 When switching an already-configured host between modes, rerun setup with `--force` (or uninstall first) so prior-mode artifacts are reconciled explicitly.
 

package/src/agents.mjs

@@ -5,23 +5,33 @@ import path from "node:path";
 export const SERVER_NAME = "flywheel";
 export const ALL_HOST_NAMES = [
   "claude",
+  "cursor",
+  "universal",
+  "antigravity",
   "opencode",
   "codex",
-  "cursor",
+  "gemini",
   "pi-mono",
   "hermes-agent",
   "openclaw",
 ];
 export const SETUP_HOST_NAMES = {
   claude: "Claude Code",
+  cursor: "Cursor",
+  universal: "Universal (.agents/skills)",
+  antigravity: "Antigravity (.agent/skills)",
   opencode: "OpenCode",
   codex: "Codex",
-  cursor: "Cursor",
+  gemini: "Gemini CLI",
   "pi-mono": "Pi (pi-mono)",
   "hermes-agent": "Hermes Agent",
   openclaw: "OpenClaw",
 };
 
+export function isSkillOnlyHost(host) {
+  return host != null && host.mcp == null;
+}
+
 const HOME = os.homedir();
 
 const hosts = {
@@ -33,13 +43,13 @@ const hosts = {
       projectPaths: [".mcp.json"],
       globalPaths: [path.join(HOME, ".claude.json")],
       configKey: "mcpServers",
-      buildEntry: ({ serverUrl, apiKey }) => ({
-        type: "http",
-        url: serverUrl,
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-        },
-      }),
+      buildEntry: ({ serverUrl, apiKey }) => {
+        const entry = { type: "http", url: serverUrl };
+        if (apiKey) {
+          entry.headers = { Authorization: `Bearer ${apiKey}` };
+        }
+        return entry;
+      },
     },
     detect: {
       projectPaths: [".mcp.json", ".claude"],
@@ -67,14 +77,13 @@ const hosts = {
         path.join(HOME, ".config", "opencode", ".opencode.jsonc"),
       ],
       configKey: "mcp",
-      buildEntry: ({ serverUrl, apiKey }) => ({
-        type: "remote",
-        url: serverUrl,
-        enabled: true,
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-        },
-      }),
+      buildEntry: ({ serverUrl, apiKey }) => {
+        const entry = { type: "remote", url: serverUrl, enabled: true };
+        if (apiKey) {
+          entry.headers = { Authorization: `Bearer ${apiKey}` };
+        }
+        return entry;
+      },
     },
     detect: {
       projectPaths: [
@@ -94,13 +103,13 @@ const hosts = {
       projectPaths: [path.join(".codex", "config.toml")],
       globalPaths: [path.join(HOME, ".codex", "config.toml")],
       configKey: "mcp_servers",
-      buildEntry: ({ serverUrl, apiKey }) => ({
-        type: "http",
-        url: serverUrl,
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-        },
-      }),
+      buildEntry: ({ serverUrl, apiKey }) => {
+        const entry = { type: "http", url: serverUrl };
+        if (apiKey) {
+          entry.headers = { Authorization: `Bearer ${apiKey}` };
+        }
+        return entry;
+      },
     },
     detect: {
       projectPaths: [".codex", path.join(".codex", "config.toml")],
@@ -115,18 +124,43 @@ const hosts = {
       projectPaths: [path.join(".cursor", "mcp.json")],
       globalPaths: [path.join(HOME, ".cursor", "mcp.json")],
       configKey: "mcpServers",
-      buildEntry: ({ serverUrl, apiKey }) => ({
-        url: serverUrl,
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-        },
-      }),
+      buildEntry: ({ serverUrl, apiKey }) => {
+        const entry = { url: serverUrl };
+        if (apiKey) {
+          entry.headers = { Authorization: `Bearer ${apiKey}` };
+        }
+        return entry;
+      },
     },
     detect: {
       projectPaths: [".cursor", path.join(".cursor", "mcp.json")],
       globalPaths: [path.join(HOME, ".cursor")],
     },
   },
+  gemini: {
+    name: "gemini",
+    displayName: "Gemini CLI",
+    mcp: {
+      configType: "json",
+      projectPaths: [path.join(".gemini", "settings.json")],
+      globalPaths: [path.join(HOME, ".gemini", "settings.json")],
+      configKey: "mcpServers",
+      buildEntry: ({ serverUrl, apiKey }) => {
+        const entry = { httpUrl: serverUrl };
+        if (apiKey) {
+          entry.headers = { Authorization: `Bearer ${apiKey}` };
+        }
+        return entry;
+      },
+    },
+    detect: {
+      projectPaths: [".gemini", path.join(".gemini", "settings.json")],
+      globalPaths: [
+        path.join(HOME, ".gemini"),
+        path.join(HOME, ".gemini", "settings.json"),
+      ],
+    },
+  },
   "pi-mono": {
     name: "pi-mono",
     displayName: "Pi (pi-mono)",
@@ -135,12 +169,13 @@ const hosts = {
       projectPaths: [path.join(".pi", "settings.json")],
       globalPaths: [path.join(HOME, ".pi", "agent", "settings.json")],
       configKey: ["mcp", "servers"],
-      buildEntry: ({ serverUrl, apiKey }) => ({
-        url: serverUrl,
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-        },
-      }),
+      buildEntry: ({ serverUrl, apiKey }) => {
+        const entry = { url: serverUrl };
+        if (apiKey) {
+          entry.headers = { Authorization: `Bearer ${apiKey}` };
+        }
+        return entry;
+      },
     },
     detect: {
       projectPaths: [".pi", path.join(".pi", "settings.json")],
@@ -155,18 +190,31 @@ const hosts = {
       projectPaths: [path.join(".hermes", "config.yaml")],
       globalPaths: [path.join(HOME, ".hermes", "config.yaml")],
       configKey: "mcp_servers",
-      buildEntry: ({ serverUrl, apiKey }) => ({
-        url: serverUrl,
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-        },
-      }),
+      buildEntry: ({ serverUrl, apiKey }) => {
+        const entry = { url: serverUrl };
+        if (apiKey) {
+          entry.headers = { Authorization: `Bearer ${apiKey}` };
+        }
+        return entry;
+      },
     },
     detect: {
       projectPaths: [".hermes", path.join(".hermes", "config.yaml")],
       globalPaths: [path.join(HOME, ".hermes"), path.join(HOME, ".hermes", "config.yaml")],
     },
   },
+  universal: {
+    name: "universal",
+    displayName: "Universal (.agents/skills)",
+    mcp: null,
+    detect: { projectPaths: [], globalPaths: [] },
+  },
+  antigravity: {
+    name: "antigravity",
+    displayName: "Antigravity (.agent/skills)",
+    mcp: null,
+    detect: { projectPaths: [], globalPaths: [] },
+  },
   openclaw: {
     name: "openclaw",
     displayName: "OpenClaw",
@@ -175,12 +223,13 @@ const hosts = {
       projectPaths: [path.join(".openclaw", "openclaw.json")],
       globalPaths: [path.join(HOME, ".openclaw", "openclaw.json")],
       configKey: ["mcp", "servers"],
-      buildEntry: ({ serverUrl, apiKey }) => ({
-        url: serverUrl,
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-        },
-      }),
+      buildEntry: ({ serverUrl, apiKey }) => {
+        const entry = { url: serverUrl };
+        if (apiKey) {
+          entry.headers = { Authorization: `Bearer ${apiKey}` };
+        }
+        return entry;
+      },
     },
     detect: {
       projectPaths: [".openclaw", path.join(".openclaw", "openclaw.json")],
@@ -200,6 +249,23 @@ export function getHost(name) {
   return host;
 }
 
+/**
+ * Names of hosts whose only role is installing skill directories — they have
+ * no MCP configuration surface and therefore no "mode" to conflict with.
+ *
+ * Code that reasons about cross-mode conflicts, ownership of shared skill
+ * paths, or skill-only retain/rollback rules must iterate THIS list rather
+ * than the wider set of hosts that happen to use the direct-copy skill
+ * install path. Specifically, Gemini CLI is MCP-capable (full `mcp` block,
+ * `httpUrl`-keyed config under `.gemini/settings.json`) but also uses the
+ * direct-copy skill path; treating it as skill-only would silently let a
+ * CLI-to-MCP transition proceed without the canonical `--force`
+ * reconciliation and leave both wirings active.
+ */
+export const SKILL_ONLY_HOST_NAMES = Object.freeze(
+  ALL_HOST_NAMES.filter((name) => isSkillOnlyHost(hosts[name])),
+);
+
 async function pathExists(filePath) {
   try {
     await access(filePath);