@phnx-labs/agents-cli 1.20.61 → 1.20.62

package/dist/lib/staleness/detectors/permissions.js

@@ -266,6 +266,28 @@ function buildKiroDetector() {
         },
     };
 }
+function buildOpenClawDetector() {
+    return {
+        kind: 'permissions',
+        agent: 'openclaw',
+        list({ versionHome }) {
+            const configPath = path.join(versionHome, '.openclaw', 'openclaw.json');
+            if (!fs.existsSync(configPath))
+                return [];
+            try {
+                const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+                const tools = config.tools;
+                const hasAllow = Array.isArray(tools?.alsoAllow) && tools.alsoAllow.length > 0;
+                const hasDeny = Array.isArray(tools?.deny) && tools.deny.length > 0;
+                if (hasAllow || hasDeny) {
+                    return discoverPermissionGroups().map(g => g.name);
+                }
+            }
+            catch { /* parse fail */ }
+            return [];
+        },
+    };
+}
 const handlers = {
     claude: buildClaudeDetector,
     codex: buildCodexDetector,
@@ -278,6 +300,7 @@ const handlers = {
     cursor: buildCursorDetector,
     droid: buildDroidDetector,
     kiro: buildKiroDetector,
+    openclaw: buildOpenClawDetector,
 };
 export const permissionsDetectors = lazyAgentMap(() => {
     const m = {};

package/dist/lib/staleness/detectors/subagents.js

@@ -2,6 +2,8 @@
  * Subagents detector. Claude/Gemini/Grok: flat .md files under `<agentDir>/agents/`.
  * Codex: flat .toml files under `<versionHome>/.codex/agents/`.
  * Droid: flat .md files under `<versionHome>/.factory/droids/`.
+ * Cursor: flat .md files under `<versionHome>/.cursor/agents/`.
+ * ForgeCode: flat .md files under `<versionHome>/.forge/agents/`.
  * OpenClaw: subdirectories containing AGENTS.md under `<versionHome>/.openclaw/`.
  * Mirrors versions.ts:521-539.
  */
@@ -74,6 +76,20 @@ function buildCopilotDetector() {
         },
     };
 }
+function buildCursorDetector() {
+    return {
+        kind: 'subagents',
+        agent: 'cursor',
+        list({ versionHome }) {
+            const agentsDir = path.join(versionHome, '.cursor', 'agents');
+            if (!fs.existsSync(agentsDir))
+                return [];
+            return fs.readdirSync(agentsDir)
+                .filter(f => f.endsWith('.md'))
+                .map(f => f.replace(/\.md$/, ''));
+        },
+    };
+}
 function buildOpenclawDetector() {
     return {
         kind: 'subagents',
@@ -117,6 +133,23 @@ function buildKiroDetector() {
         },
     };
 }
+function buildForgeDetector() {
+    return buildFlatMdAgentsDetector('forge', '.forge');
+}
+function buildGooseDetector() {
+    return {
+        kind: 'subagents',
+        agent: 'goose',
+        list({ versionHome }) {
+            const agentsDir = path.join(versionHome, '.config', 'goose', 'agents');
+            if (!fs.existsSync(agentsDir))
+                return [];
+            return fs.readdirSync(agentsDir)
+                .filter(f => f.endsWith('.yaml'))
+                .map(f => f.replace(/\.yaml$/, ''));
+        },
+    };
+}
 function buildOpenCodeDetector() {
     return {
         kind: 'subagents',
@@ -157,6 +190,9 @@ const handlers = {
     droid: buildDroidDetector,
     openclaw: buildOpenclawDetector,
     kiro: buildKiroDetector,
+    cursor: buildCursorDetector,
+    forge: buildForgeDetector,
+    goose: buildGooseDetector,
 };
 export const subagentsDetectors = lazyAgentMap(() => {
     const m = {};

package/dist/lib/staleness/writers/commands.js

@@ -25,6 +25,7 @@ import { safeJoin } from '../../paths.js';
 import { markdownToToml } from '../../convert.js';
 import { commandAppliesTo, parseCommandMetadata } from '../../commands.js';
 import { installCommandSkillToVersion, shouldInstallCommandAsSkill } from '../../command-skills.js';
+import { installGooseCommandToVersion } from '../../goose-commands.js';
 import { resolveCommandSource, trustedSkillRoots } from './sources.js';
 import { lazyAgentMap } from './lazy-map.js';
 function buildCommandsWriter(agent) {
@@ -59,6 +60,12 @@ function buildCommandsWriter(agent) {
                     if (!installed.success)
                         continue;
                 }
+                else if (agent === 'goose') {
+                    // Goose: recipe YAML + config.yaml slash_commands entry, not a file copy.
+                    const installed = installGooseCommandToVersion(versionHome, cmd, srcFile);
+                    if (!installed.success)
+                        continue;
+                }
                 else if (agentConfig.format === 'toml') {
                     const content = fs.readFileSync(srcFile, 'utf-8');
                     const tomlContent = markdownToToml(cmd, content);

package/dist/lib/staleness/writers/hooks.js

@@ -36,7 +36,7 @@ function buildHooksWriter(agent) {
             // registerHooksForGrok — file copy alone only sees top-level available.hooks
             // names (RUSH-1353). Copilot/Kiro/Goose load managed *.json under their
             // hooks dirs the same way.
-            if (agent === 'claude' || agent === 'codex' || agent === 'gemini' || agent === 'antigravity' || agent === 'kimi' || agent === 'droid' || agent === 'copilot' || agent === 'kiro' || agent === 'goose' || agent === 'cursor' || agent === 'grok') {
+            if (agent === 'claude' || agent === 'codex' || agent === 'gemini' || agent === 'antigravity' || agent === 'kimi' || agent === 'droid' || agent === 'copilot' || agent === 'kiro' || agent === 'goose' || agent === 'cursor' || agent === 'grok' || agent === 'hermes') {
                 registerHooksToSettings(agent, versionHome);
             }
             return { synced };

package/dist/lib/staleness/writers/subagents.js

@@ -3,8 +3,9 @@
  * .md file under their native agents directory. Codex writes TOML under
  * `.codex/agents/`.
  * Droid (Factory AI) flattens each into a custom droid .md under
- * `<versionHome>/.factory/droids/`. OpenClaw copies the full subagent
- * directory (with AGENT.md renamed to AGENTS.md) into
+ * `<versionHome>/.factory/droids/`. Cursor flattens each into a custom
+ * subagent .md under `<versionHome>/.cursor/agents/`. OpenClaw copies the
+ * full subagent directory (with AGENT.md renamed to AGENTS.md) into
  * `<versionHome>/.openclaw/<name>/`.
  *
  * Source-side discovery is `listInstalledSubagents` from lib/subagents.ts —
@@ -14,7 +15,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { capableAgents } from '../../capabilities.js';
-import { listInstalledSubagents, transformSubagentForClaude, transformSubagentForCodex, transformSubagentForCopilot, writeKimiSubagentFiles, buildKimiSubagentsParentYaml, KIMI_SUBAGENTS_PARENT_FILE, transformSubagentForOpenCode, transformSubagentForAntigravity, transformSubagentForDroid, transformSubagentForKiro, syncSubagentToOpenclaw, parseSubagentFrontmatter, } from '../../subagents.js';
+import { listInstalledSubagents, transformSubagentForClaude, transformSubagentForCodex, transformSubagentForCopilot, writeKimiSubagentFiles, buildKimiSubagentsParentYaml, KIMI_SUBAGENTS_PARENT_FILE, transformSubagentForOpenCode, transformSubagentForAntigravity, transformSubagentForDroid, transformSubagentForForge, transformSubagentForKiro, transformSubagentForCursor, transformSubagentForGoose, syncSubagentToOpenclaw, parseSubagentFrontmatter, } from '../../subagents.js';
 import { safeJoin } from '../../paths.js';
 import { lazyAgentMap } from './lazy-map.js';
 function buildSubagentsWriter(agent) {
@@ -83,6 +84,24 @@ function buildSubagentsWriter(agent) {
                         fs.writeFileSync(safeJoin(agentsDir, `${sub.name}.json`), transformSubagentForKiro(sub.path));
                         synced.push(sub.name);
                     }
+                    else if (agent === 'cursor') {
+                        const agentsDir = path.join(versionHome, '.cursor', 'agents');
+                        fs.mkdirSync(agentsDir, { recursive: true });
+                        fs.writeFileSync(safeJoin(agentsDir, `${sub.name}.md`), transformSubagentForCursor(sub.path));
+                        synced.push(sub.name);
+                    }
+                    else if (agent === 'forge') {
+                        const agentsDir = path.join(versionHome, '.forge', 'agents');
+                        fs.mkdirSync(agentsDir, { recursive: true });
+                        fs.writeFileSync(safeJoin(agentsDir, `${sub.name}.md`), transformSubagentForForge(sub.path));
+                        synced.push(sub.name);
+                    }
+                    else if (agent === 'goose') {
+                        const agentsDir = path.join(versionHome, '.config', 'goose', 'agents');
+                        fs.mkdirSync(agentsDir, { recursive: true });
+                        fs.writeFileSync(safeJoin(agentsDir, `${sub.name}.yaml`), transformSubagentForGoose(sub.path));
+                        synced.push(sub.name);
+                    }
                 }
                 catch { /* per-item sync failure: skip */ }
             }

package/dist/lib/subagents.d.ts

@@ -68,6 +68,27 @@ export declare function transformSubagentForDroid(subagentDir: string): string;
  * See GitHub docs for custom agents.
  */
 export declare const transformSubagentForCopilot: typeof transformSubagentForDroid;
+/**
+ * Transform a subagent into a Cursor CLI custom subagent `.md` file.
+ *
+ * Cursor loads subagents from `.cursor/agents/*.md` (project) or
+ * `~/.cursor/agents/*.md` (user) — Markdown with YAML frontmatter
+ * (name, description, model; also readonly/is_background, which our
+ * frontmatter schema doesn't carry). Cursor has no `color` field, so this is
+ * an alias of transformSubagentForDroid, same as Copilot.
+ * See https://cursor.com/docs/subagents.
+ */
+export declare const transformSubagentForCursor: typeof transformSubagentForDroid;
+/**
+ * Transform a subagent into a ForgeCode custom subagent `.md` file.
+ *
+ * ForgeCode loads named agents from `.forge/agents/*.md` (project) or
+ * `~/.forge/agents/*.md` (user) — Markdown with YAML frontmatter (id, title,
+ * description, tools, model, temperature) + a system-prompt body. ForgeCode has
+ * no `color` field, so this is an alias of transformSubagentForDroid, same as
+ * Copilot/Cursor. See https://forgecode.dev/docs/agent-definition-guide/.
+ */
+export declare const transformSubagentForForge: typeof transformSubagentForDroid;
 /**
  * Transform a subagent into Antigravity's custom-agent markdown shape.
  *
@@ -138,6 +159,17 @@ export declare function transformSubagentForCodex(subagentDir: string): string;
  * set so the subagent can actually run.
  */
 export declare function transformSubagentForKiro(subagentDir: string): string;
+/**
+ * Transform a subagent into a Goose recipe YAML file.
+ *
+ * Goose has no dedicated subagent file format — a named subagent IS a recipe.
+ * Goose resolves named agents from `~/.config/goose/agents/<name>.yaml` (global)
+ * and delegates to them by name in autonomous mode. The recipe schema mirrors the
+ * one agents-cli already emits for Goose workflow recipes (`writeGooseSubrecipe`):
+ * `version`, `title`, `description`, `instructions`, `prompt`, plus an optional
+ * `settings.goose_model`. See goose-docs.ai context-engineering/subagents.
+ */
+export declare function transformSubagentForGoose(subagentDir: string): string;
 /**
  * Sync a subagent to an OpenClaw workspace
  * Copies full directory, renames AGENT.md to AGENTS.md

package/dist/lib/subagents.js

@@ -274,6 +274,27 @@ export function transformSubagentForDroid(subagentDir) {
  * See GitHub docs for custom agents.
  */
 export const transformSubagentForCopilot = transformSubagentForDroid;
+/**
+ * Transform a subagent into a Cursor CLI custom subagent `.md` file.
+ *
+ * Cursor loads subagents from `.cursor/agents/*.md` (project) or
+ * `~/.cursor/agents/*.md` (user) — Markdown with YAML frontmatter
+ * (name, description, model; also readonly/is_background, which our
+ * frontmatter schema doesn't carry). Cursor has no `color` field, so this is
+ * an alias of transformSubagentForDroid, same as Copilot.
+ * See https://cursor.com/docs/subagents.
+ */
+export const transformSubagentForCursor = transformSubagentForDroid;
+/**
+ * Transform a subagent into a ForgeCode custom subagent `.md` file.
+ *
+ * ForgeCode loads named agents from `.forge/agents/*.md` (project) or
+ * `~/.forge/agents/*.md` (user) — Markdown with YAML frontmatter (id, title,
+ * description, tools, model, temperature) + a system-prompt body. ForgeCode has
+ * no `color` field, so this is an alias of transformSubagentForDroid, same as
+ * Copilot/Cursor. See https://forgecode.dev/docs/agent-definition-guide/.
+ */
+export const transformSubagentForForge = transformSubagentForDroid;
 /**
  * Transform a subagent into Antigravity's custom-agent markdown shape.
  *
@@ -493,6 +514,45 @@ export function transformSubagentForKiro(subagentDir) {
     }
     return JSON.stringify(config, null, 2);
 }
+/**
+ * Transform a subagent into a Goose recipe YAML file.
+ *
+ * Goose has no dedicated subagent file format — a named subagent IS a recipe.
+ * Goose resolves named agents from `~/.config/goose/agents/<name>.yaml` (global)
+ * and delegates to them by name in autonomous mode. The recipe schema mirrors the
+ * one agents-cli already emits for Goose workflow recipes (`writeGooseSubrecipe`):
+ * `version`, `title`, `description`, `instructions`, `prompt`, plus an optional
+ * `settings.goose_model`. See goose-docs.ai context-engineering/subagents.
+ */
+export function transformSubagentForGoose(subagentDir) {
+    const agentMd = path.join(subagentDir, 'AGENT.md');
+    const frontmatter = parseSubagentFrontmatter(agentMd);
+    const body = getSubagentBody(agentMd);
+    if (!frontmatter) {
+        throw new Error(`Invalid AGENT.md in ${subagentDir}`);
+    }
+    const files = fs.readdirSync(subagentDir)
+        .filter(f => f.endsWith('.md') && f !== 'AGENT.md')
+        .sort();
+    let prompt = body || frontmatter.description || frontmatter.name;
+    for (const file of files) {
+        const content = fs.readFileSync(path.join(subagentDir, file), 'utf-8').trim();
+        const sectionName = file.replace('.md', '');
+        const title = sectionName.charAt(0).toUpperCase() + sectionName.slice(1).toLowerCase();
+        prompt += `\n\n## ${title}\n\n${content}`;
+    }
+    const recipe = {
+        version: '1.0.0',
+        title: frontmatter.name || path.basename(subagentDir),
+        description: frontmatter.description || frontmatter.name || path.basename(subagentDir),
+        instructions: prompt,
+        prompt,
+    };
+    if (frontmatter.model) {
+        recipe.settings = { goose_model: frontmatter.model };
+    }
+    return yaml.stringify(recipe);
+}
 /**
  * Sync a subagent to an OpenClaw workspace
  * Copies full directory, renames AGENT.md to AGENTS.md
@@ -609,6 +669,51 @@ export function installSubagentToAgent(subagentDir, subagentName, agent, agentHo
             return { success: false, error: String(err) };
         }
     }
+    else if (agent === 'cursor') {
+        // Cursor: flattened .md custom subagent under ~/.cursor/agents/
+        const agentsDir = path.join(agentHome, '.cursor', 'agents');
+        if (!fs.existsSync(agentsDir)) {
+            fs.mkdirSync(agentsDir, { recursive: true });
+        }
+        try {
+            const transformed = transformSubagentForCursor(subagentDir);
+            fs.writeFileSync(safeJoin(agentsDir, `${subagentName}.md`), transformed);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
+    else if (agent === 'forge') {
+        // ForgeCode: flattened .md custom subagent under ~/.forge/agents/
+        const agentsDir = path.join(agentHome, '.forge', 'agents');
+        if (!fs.existsSync(agentsDir)) {
+            fs.mkdirSync(agentsDir, { recursive: true });
+        }
+        try {
+            const transformed = transformSubagentForForge(subagentDir);
+            fs.writeFileSync(safeJoin(agentsDir, `${subagentName}.md`), transformed);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
+    else if (agent === 'goose') {
+        // Goose: recipe YAML custom-agent file under ~/.config/goose/agents/
+        const agentsDir = path.join(agentHome, '.config', 'goose', 'agents');
+        if (!fs.existsSync(agentsDir)) {
+            fs.mkdirSync(agentsDir, { recursive: true });
+        }
+        try {
+            const transformed = transformSubagentForGoose(subagentDir);
+            fs.writeFileSync(safeJoin(agentsDir, `${subagentName}.yaml`), transformed);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
     else {
         // Other agents don't support subagents yet
         return { success: false, error: `Agent '${agent}' does not support subagents` };
@@ -670,6 +775,27 @@ export function removeSubagentFromAgent(subagentName, agent, agentHome) {
             }
             return { success: true };
         }
+        else if (agent === 'cursor') {
+            const targetPath = safeJoin(path.join(agentHome, '.cursor', 'agents'), `${subagentName}.md`);
+            if (fs.existsSync(targetPath)) {
+                fs.unlinkSync(targetPath);
+            }
+            return { success: true };
+        }
+        else if (agent === 'forge') {
+            const targetPath = safeJoin(path.join(agentHome, '.forge', 'agents'), `${subagentName}.md`);
+            if (fs.existsSync(targetPath)) {
+                fs.unlinkSync(targetPath);
+            }
+            return { success: true };
+        }
+        else if (agent === 'goose') {
+            const targetPath = safeJoin(path.join(agentHome, '.config', 'goose', 'agents'), `${subagentName}.yaml`);
+            if (fs.existsSync(targetPath)) {
+                fs.unlinkSync(targetPath);
+            }
+            return { success: true };
+        }
         else {
             return { success: true }; // No-op for unsupported agents
         }
@@ -886,6 +1012,61 @@ export function listSubagentsForAgent(agentId, home) {
             });
         }
     }
+    else if (agentId === 'cursor') {
+        // Cursor: flat `<name>.md` files under ~/.cursor/agents/
+        const agentsDir = path.join(home, '.cursor', 'agents');
+        if (!fs.existsSync(agentsDir))
+            return subagents;
+        for (const file of fs.readdirSync(agentsDir)) {
+            if (!file.endsWith('.md'))
+                continue;
+            const filePath = path.join(agentsDir, file);
+            if (!fs.statSync(filePath).isFile())
+                continue;
+            const name = file.replace(/\.md$/, '');
+            const frontmatter = parseSubagentFrontmatter(filePath) ?? { name, description: '' };
+            subagents.push({ name, path: filePath, files: [file], frontmatter });
+        }
+    }
+    else if (agentId === 'forge') {
+        // ForgeCode: flat `<name>.md` files under ~/.forge/agents/
+        const agentsDir = path.join(home, '.forge', 'agents');
+        if (!fs.existsSync(agentsDir))
+            return subagents;
+        for (const file of fs.readdirSync(agentsDir)) {
+            if (!file.endsWith('.md'))
+                continue;
+            const filePath = path.join(agentsDir, file);
+            if (!fs.statSync(filePath).isFile())
+                continue;
+            const name = file.replace(/\.md$/, '');
+            const frontmatter = parseSubagentFrontmatter(filePath) ?? { name, description: '' };
+            subagents.push({ name, path: filePath, files: [file], frontmatter });
+        }
+    }
+    else if (agentId === 'goose') {
+        // Goose: recipe YAML files under ~/.config/goose/agents/
+        const agentsDir = path.join(home, '.config', 'goose', 'agents');
+        if (!fs.existsSync(agentsDir))
+            return subagents;
+        for (const file of fs.readdirSync(agentsDir)) {
+            if (!file.endsWith('.yaml'))
+                continue;
+            const filePath = path.join(agentsDir, file);
+            if (!fs.statSync(filePath).isFile())
+                continue;
+            const name = file.replace(/\.yaml$/, '');
+            let frontmatter;
+            try {
+                const recipe = yaml.parse(fs.readFileSync(filePath, 'utf-8'));
+                frontmatter = { name: recipe?.title || name, description: recipe?.description || '' };
+            }
+            catch {
+                continue;
+            }
+            subagents.push({ name, path: filePath, files: [file], frontmatter });
+        }
+    }
     return subagents;
 }
 /**
@@ -984,6 +1165,42 @@ export function diffVersionSubagents(agent, version) {
             }
         }
     }
+    else if (agent === 'cursor') {
+        const agentsDir = path.join(versionHome, '.cursor', 'agents');
+        if (fs.existsSync(agentsDir)) {
+            for (const file of fs.readdirSync(agentsDir)) {
+                if (!file.endsWith('.md'))
+                    continue;
+                const name = path.basename(file, '.md');
+                if (!discovered.has(name))
+                    orphans.push(name);
+            }
+        }
+    }
+    else if (agent === 'forge') {
+        const agentsDir = path.join(versionHome, '.forge', 'agents');
+        if (fs.existsSync(agentsDir)) {
+            for (const file of fs.readdirSync(agentsDir)) {
+                if (!file.endsWith('.md'))
+                    continue;
+                const name = path.basename(file, '.md');
+                if (!discovered.has(name))
+                    orphans.push(name);
+            }
+        }
+    }
+    else if (agent === 'goose') {
+        const agentsDir = path.join(versionHome, '.config', 'goose', 'agents');
+        if (fs.existsSync(agentsDir)) {
+            for (const file of fs.readdirSync(agentsDir)) {
+                if (!file.endsWith('.yaml'))
+                    continue;
+                const name = path.basename(file, '.yaml');
+                if (!discovered.has(name))
+                    orphans.push(name);
+            }
+        }
+    }
     return { agent, version, orphans: orphans.sort() };
 }
 /**
@@ -1071,6 +1288,27 @@ export function removeSubagentFromVersion(agent, version, subagentName) {
                 fs.renameSync(targetPath, path.join(trashDir, `${subagentName}.json.${stamp}`));
             }
         }
+        else if (agent === 'cursor') {
+            const targetPath = path.join(versionHome, '.cursor', 'agents', `${subagentName}.md`);
+            if (fs.existsSync(targetPath)) {
+                fs.mkdirSync(trashDir, { recursive: true, mode: 0o700 });
+                fs.renameSync(targetPath, path.join(trashDir, `${subagentName}.md.${stamp}`));
+            }
+        }
+        else if (agent === 'forge') {
+            const targetPath = path.join(versionHome, '.forge', 'agents', `${subagentName}.md`);
+            if (fs.existsSync(targetPath)) {
+                fs.mkdirSync(trashDir, { recursive: true, mode: 0o700 });
+                fs.renameSync(targetPath, path.join(trashDir, `${subagentName}.md.${stamp}`));
+            }
+        }
+        else if (agent === 'goose') {
+            const targetPath = path.join(versionHome, '.config', 'goose', 'agents', `${subagentName}.yaml`);
+            if (fs.existsSync(targetPath)) {
+                fs.mkdirSync(trashDir, { recursive: true, mode: 0o700 });
+                fs.renameSync(targetPath, path.join(trashDir, `${subagentName}.yaml.${stamp}`));
+            }
+        }
         return { success: true };
     }
     catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phnx-labs/agents-cli",
-  "version": "1.20.61",
+  "version": "1.20.62",
   "description": "One CLI for all your AI coding agents - versions, config, cloud dispatch, sessions, and teams (now with first-class Grok Build CLI support)",
   "type": "module",
   "main": "dist/index.js",