@phnx-labs/agents-cli 1.20.58 → 1.20.60

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

@@ -1,5 +1,5 @@
 /**
- * Subagents detector. Claude: flat .md files under `<agentDir>/agents/`.
+ * 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/`.
  * OpenClaw: subdirectories containing AGENTS.md under `<versionHome>/.openclaw/`.
@@ -29,6 +29,9 @@ function buildClaudeDetector() {
 function buildGrokDetector() {
     return buildFlatMdAgentsDetector('grok', '.grok');
 }
+function buildGeminiDetector() {
+    return buildFlatMdAgentsDetector('gemini', '.gemini');
+}
 function buildCodexDetector() {
     return {
         kind: 'subagents',
@@ -85,32 +88,32 @@ function buildOpenclawDetector() {
         },
     };
 }
-function buildKiroDetector() {
+function buildKimiDetector() {
     return {
         kind: 'subagents',
-        agent: 'kiro',
+        agent: 'kimi',
         list({ versionHome }) {
-            const agentsDir = path.join(versionHome, '.kiro', 'agents');
+            const agentsDir = path.join(versionHome, '.kimi-code', 'agents');
             if (!fs.existsSync(agentsDir))
                 return [];
+            // Parent is `_agents-cli.yaml` (underscore-prefixed reserved name).
             return fs.readdirSync(agentsDir)
-                .filter(f => f.endsWith('.json'))
-                .map(f => f.replace('.json', ''));
+                .filter(f => f.endsWith('.yaml') && !f.startsWith('_'))
+                .map(f => f.replace(/\.yaml$/, ''));
         },
     };
 }
-function buildKimiDetector() {
+function buildKiroDetector() {
     return {
         kind: 'subagents',
-        agent: 'kimi',
+        agent: 'kiro',
         list({ versionHome }) {
-            const agentsDir = path.join(versionHome, '.kimi-code', 'agents');
+            const agentsDir = path.join(versionHome, '.kiro', 'agents');
             if (!fs.existsSync(agentsDir))
                 return [];
-            // Parent is `_agents-cli.yaml` (underscore-prefixed reserved name).
             return fs.readdirSync(agentsDir)
-                .filter(f => f.endsWith('.yaml') && !f.startsWith('_'))
-                .map(f => f.replace(/\.yaml$/, ''));
+                .filter(f => f.endsWith('.json'))
+                .map(f => f.replace(/\.json$/, ''));
         },
     };
 }
@@ -128,13 +131,29 @@ function buildOpenCodeDetector() {
         },
     };
 }
+function buildAntigravityDetector() {
+    return {
+        kind: 'subagents',
+        agent: 'antigravity',
+        list({ versionHome }) {
+            const agentsDir = path.join(versionHome, '.gemini', 'config', 'agents');
+            if (!fs.existsSync(agentsDir))
+                return [];
+            return fs.readdirSync(agentsDir, { withFileTypes: true })
+                .filter(d => d.isDirectory() && fs.existsSync(path.join(agentsDir, d.name, 'agent.md')))
+                .map(d => d.name);
+        },
+    };
+}
 const handlers = {
     claude: buildClaudeDetector,
     copilot: buildCopilotDetector,
+    gemini: buildGeminiDetector,
     grok: buildGrokDetector,
     codex: buildCodexDetector,
     kimi: buildKimiDetector,
     opencode: buildOpenCodeDetector,
+    antigravity: buildAntigravityDetector,
     droid: buildDroidDetector,
     openclaw: buildOpenclawDetector,
     kiro: buildKiroDetector,

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

@@ -4,6 +4,7 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
+import * as yaml from 'yaml';
 import { capableAgents } from '../../capabilities.js';
 import { lazyAgentMap } from '../writers/lazy-map.js';
 function buildWorkflowsDetector(agent) {
@@ -11,6 +12,38 @@ function buildWorkflowsDetector(agent) {
         kind: 'workflows',
         agent,
         list({ versionHome }) {
+            if (agent === 'kimi') {
+                const skillsDir = path.join(versionHome, '.kimi-code', 'skills');
+                if (!fs.existsSync(skillsDir))
+                    return [];
+                return fs.readdirSync(skillsDir, { withFileTypes: true })
+                    .filter(d => d.isDirectory() && fs.existsSync(path.join(skillsDir, d.name, 'SKILL.md')))
+                    .filter(d => {
+                    try {
+                        const skill = fs.readFileSync(path.join(skillsDir, d.name, 'SKILL.md'), 'utf-8');
+                        const lines = skill.split('\n');
+                        if (lines[0] !== '---')
+                            return false;
+                        const endIndex = lines.slice(1).findIndex(l => l === '---');
+                        if (endIndex < 0)
+                            return false;
+                        const parsed = yaml.parse(lines.slice(1, endIndex + 1).join('\n'));
+                        return parsed?.type === 'flow' && parsed.agents_workflow === d.name;
+                    }
+                    catch {
+                        return false;
+                    }
+                })
+                    .map(d => d.name);
+            }
+            if (agent === 'goose') {
+                const recipesDir = path.join(versionHome, '.config', 'goose', 'recipes');
+                if (!fs.existsSync(recipesDir))
+                    return [];
+                return fs.readdirSync(recipesDir, { withFileTypes: true })
+                    .filter(d => d.isFile() && d.name.endsWith('.yaml') && !d.name.startsWith('.'))
+                    .map(d => d.name.slice(0, -'.yaml'.length));
+            }
             const workflowsDir = path.join(versionHome, 'workflows');
             if (!fs.existsSync(workflowsDir))
                 return [];

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

@@ -36,10 +36,10 @@ function buildCommandsWriter(agent) {
             const agentDir = path.join(versionHome, agentConfigDirName(agent));
             const commandsAsSkills = shouldInstallCommandAsSkill(agent, version);
             const supportsCommands = supports(agent, 'commands', version).ok;
-            // Writers fire only after supports() OR commands-as-skills says yes —
-            // both paths produce a usable result here.
+            // Version-gated agents (e.g. goose skills >= 1.25.0) are registered but
+            // may be called at a version too old for both paths — skip gracefully.
             if (!commandsAsSkills && !supportsCommands) {
-                throw new Error(`commands writer reached for ${agent}@${version} with no path (cmd=false, asSkill=false)`);
+                return { synced: [] };
             }
             const skillRoots = trustedSkillRoots();
             const commandsTarget = path.join(agentDir, agentConfig.commandsSubdir);

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

@@ -1,6 +1,7 @@
 /**
- * Subagents writer. Claude flattens each subagent into a single .md file
- * under `<agentDir>/agents/`. Codex writes TOML under `.codex/agents/`.
+ * Subagents writer. Claude/Gemini/Grok flatten each subagent into a single
+ * .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
@@ -13,7 +14,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, transformSubagentForDroid, transformSubagentForKiro, syncSubagentToOpenclaw, parseSubagentFrontmatter, } from '../../subagents.js';
+import { listInstalledSubagents, transformSubagentForClaude, transformSubagentForCodex, transformSubagentForCopilot, writeKimiSubagentFiles, buildKimiSubagentsParentYaml, KIMI_SUBAGENTS_PARENT_FILE, transformSubagentForOpenCode, transformSubagentForAntigravity, transformSubagentForDroid, transformSubagentForKiro, syncSubagentToOpenclaw, parseSubagentFrontmatter, } from '../../subagents.js';
 import { safeJoin } from '../../paths.js';
 import { lazyAgentMap } from './lazy-map.js';
 function buildSubagentsWriter(agent) {
@@ -29,8 +30,9 @@ function buildSubagentsWriter(agent) {
                 if (!sub)
                     continue;
                 try {
-                    if (agent === 'claude' || agent === 'grok') {
-                        const agentsDir = path.join(versionHome, agent === 'grok' ? '.grok' : '.claude', 'agents');
+                    if (agent === 'claude' || agent === 'gemini' || agent === 'grok') {
+                        const agentsRoot = agent === 'grok' ? '.grok' : agent === 'gemini' ? '.gemini' : '.claude';
+                        const agentsDir = path.join(versionHome, agentsRoot, 'agents');
                         fs.mkdirSync(agentsDir, { recursive: true });
                         fs.writeFileSync(safeJoin(agentsDir, `${sub.name}.md`), transformSubagentForClaude(sub.path));
                         synced.push(sub.name);
@@ -51,6 +53,12 @@ function buildSubagentsWriter(agent) {
                         fs.writeFileSync(safeJoin(agentsDir, `${sub.name}.md`), transformSubagentForOpenCode(sub.path));
                         synced.push(sub.name);
                     }
+                    else if (agent === 'antigravity') {
+                        const agentDir = safeJoin(path.join(versionHome, '.gemini', 'config', 'agents'), sub.name);
+                        fs.mkdirSync(agentDir, { recursive: true });
+                        fs.writeFileSync(safeJoin(agentDir, 'agent.md'), transformSubagentForAntigravity(sub.path));
+                        synced.push(sub.name);
+                    }
                     else if (agent === 'droid') {
                         const droidsDir = path.join(versionHome, '.factory', 'droids');
                         fs.mkdirSync(droidsDir, { recursive: true });

package/dist/lib/startup/command-registry.d.ts

@@ -65,6 +65,7 @@ export declare const loadDrive: ModuleLoader;
 export declare const loadFactory: ModuleLoader;
 export declare const loadUsage: ModuleLoader;
 export declare const loadCost: ModuleLoader;
+export declare const loadOutput: ModuleLoader;
 export declare const loadBudget: ModuleLoader;
 export declare const loadAlias: ModuleLoader;
 export declare const loadPty: ModuleLoader;

package/dist/lib/startup/command-registry.js

@@ -43,6 +43,7 @@ export const loadDrive = async () => (await import('../../commands/drive.js')).r
 export const loadFactory = async () => (await import('../../commands/factory.js')).registerFactoryCommands;
 export const loadUsage = async () => (await import('../../commands/usage.js')).registerUsageCommand;
 export const loadCost = async () => (await import('../../commands/cost.js')).registerCostCommand;
+export const loadOutput = async () => (await import('../../commands/output.js')).registerOutputCommand;
 export const loadBudget = async () => (await import('../../commands/budget.js')).registerBudgetCommand;
 export const loadAlias = async () => (await import('../../commands/alias.js')).registerAliasCommand;
 export const loadPty = async () => (await import('../../commands/pty.js')).registerPtyCommands;
@@ -137,6 +138,7 @@ export const COMMAND_LOADERS = {
     factory: [loadFactory],
     usage: [loadUsage],
     cost: [loadCost],
+    output: [loadOutput],
     budget: [loadBudget],
     alias: [loadAlias],
     pty: [loadPty],

package/dist/lib/subagents.d.ts

@@ -68,6 +68,15 @@ export declare function transformSubagentForDroid(subagentDir: string): string;
  * See GitHub docs for custom agents.
  */
 export declare const transformSubagentForCopilot: typeof transformSubagentForDroid;
+/**
+ * Transform a subagent into Antigravity's custom-agent markdown shape.
+ *
+ * Antigravity exposes custom agents as Markdown files with YAML frontmatter,
+ * close to Gemini CLI subagents. Keep portable frontmatter fields and flatten
+ * sibling markdown files into the prompt body like the other markdown-backed
+ * agents.
+ */
+export declare function transformSubagentForAntigravity(subagentDir: string): string;
 /**
  * Transform a subagent into an OpenCode agent markdown file.
  *
@@ -157,8 +166,9 @@ export declare function removeSubagentFromAgent(subagentName: string, agent: Age
 export declare function subagentContentMatches(installedDir: string, sourceDir: string): boolean;
 /**
  * List subagents installed to a specific agent's home
- * Claude: scans ~/.claude/agents/{name}.md
+ * Claude/Gemini/Grok: scans ~/.{agent}/agents/{name}.md
  * Kimi: scans ~/.kimi-code/agents/{name}.yaml (+ sibling .system.md)
+ * Kiro: scans ~/.kiro/agents/{name}.json
  * OpenClaw: scans ~/.openclaw/{name}/AGENTS.md
  */
 export declare function listSubagentsForAgent(agentId: AgentId, home: string): InstalledSubagent[];

package/dist/lib/subagents.js

@@ -274,6 +274,39 @@ export function transformSubagentForDroid(subagentDir) {
  * See GitHub docs for custom agents.
  */
 export const transformSubagentForCopilot = transformSubagentForDroid;
+/**
+ * Transform a subagent into Antigravity's custom-agent markdown shape.
+ *
+ * Antigravity exposes custom agents as Markdown files with YAML frontmatter,
+ * close to Gemini CLI subagents. Keep portable frontmatter fields and flatten
+ * sibling markdown files into the prompt body like the other markdown-backed
+ * agents.
+ */
+export function transformSubagentForAntigravity(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 frontmatterYaml = yaml.stringify({
+        name: frontmatter.name,
+        description: frontmatter.description,
+        kind: 'local',
+        ...(frontmatter.model && { model: frontmatter.model }),
+    }).trim();
+    let result = `---\n${frontmatterYaml}\n---\n\n${body}`;
+    const files = fs.readdirSync(subagentDir)
+        .filter(f => f.endsWith('.md') && f !== 'AGENT.md')
+        .sort();
+    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();
+        result += `\n\n## ${title}\n\n${content}`;
+    }
+    return `${result.trim()}\n`;
+}
 /**
  * Transform a subagent into an OpenCode agent markdown file.
  *
@@ -393,21 +426,10 @@ export function writeKimiSubagentFiles(agentsDir, subagentDir, name) {
 export function transformSubagentForCodex(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}`);
     }
-    // Append other .md files into the developer_instructions body.
-    let instructions = body.trim();
-    const files = fs.readdirSync(subagentDir)
-        .filter(f => f.endsWith('.md') && f !== 'AGENT.md')
-        .sort();
-    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();
-        instructions += `\n\n## ${title}\n\n${content}`;
-    }
+    const instructions = flattenSubagentInstructions(subagentDir);
     // Escape TOML multi-line string (""") content — only """ needs escaping.
     const safeInstructions = instructions.replace(/"""/g, '\\"""');
     const safeName = frontmatter.name.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
@@ -421,6 +443,19 @@ export function transformSubagentForCodex(subagentDir) {
     toml += `developer_instructions = """\n${safeInstructions}\n"""\n`;
     return toml;
 }
+function flattenSubagentInstructions(subagentDir) {
+    let instructions = getSubagentBody(path.join(subagentDir, 'AGENT.md')).trim();
+    const files = fs.readdirSync(subagentDir)
+        .filter(f => f.endsWith('.md') && f !== 'AGENT.md')
+        .sort();
+    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();
+        instructions += `\n\n## ${title}\n\n${content}`;
+    }
+    return instructions;
+}
 /**
  * Transform a subagent into a Kiro CLI custom-agent JSON file.
  *
@@ -487,10 +522,10 @@ export function syncSubagentToOpenclaw(subagentDir, targetDir) {
  * Install a subagent to a specific agent's home
  */
 export function installSubagentToAgent(subagentDir, subagentName, agent, agentHome) {
-    if (agent === 'claude' || agent === 'grok') {
-        // Claude / Grok: flatten to single .md under ~/.claude/agents or ~/.grok/agents
-        // Grok discovers user agent defs from ~/.grok/agents/*.md (same shape as Claude).
-        const agentsDir = path.join(agentHome, agent === 'grok' ? '.grok' : '.claude', 'agents');
+    if (agent === 'claude' || agent === 'gemini' || agent === 'grok') {
+        // Claude / Gemini / Grok: flatten to single .md under the native agents dir.
+        const agentsRoot = agent === 'grok' ? '.grok' : agent === 'gemini' ? '.gemini' : '.claude';
+        const agentsDir = path.join(agentHome, agentsRoot, 'agents');
         if (!fs.existsSync(agentsDir)) {
             fs.mkdirSync(agentsDir, { recursive: true });
         }
@@ -541,6 +576,19 @@ export function installSubagentToAgent(subagentDir, subagentName, agent, agentHo
             return { success: false, error: String(err) };
         }
     }
+    else if (agent === 'antigravity') {
+        // Antigravity: custom-agent markdown under ~/.gemini/config/agents/<name>/agent.md.
+        const agentDir = safeJoin(path.join(agentHome, '.gemini', 'config', 'agents'), subagentName);
+        if (!fs.existsSync(agentDir))
+            fs.mkdirSync(agentDir, { recursive: true });
+        try {
+            fs.writeFileSync(safeJoin(agentDir, 'agent.md'), transformSubagentForAntigravity(subagentDir));
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
     else if (agent === 'openclaw') {
         // OpenClaw: copy full directory
         const targetDir = safeJoin(path.join(agentHome, '.openclaw'), subagentName);
@@ -571,8 +619,8 @@ export function installSubagentToAgent(subagentDir, subagentName, agent, agentHo
  */
 export function removeSubagentFromAgent(subagentName, agent, agentHome) {
     try {
-        if (agent === 'claude' || agent === 'grok') {
-            const agentsRoot = agent === 'grok' ? '.grok' : '.claude';
+        if (agent === 'claude' || agent === 'gemini' || agent === 'grok') {
+            const agentsRoot = agent === 'grok' ? '.grok' : agent === 'gemini' ? '.gemini' : '.claude';
             const targetPath = safeJoin(path.join(agentHome, agentsRoot, 'agents'), `${subagentName}.md`);
             if (fs.existsSync(targetPath)) {
                 fs.unlinkSync(targetPath);
@@ -602,6 +650,12 @@ export function removeSubagentFromAgent(subagentName, agent, agentHome) {
                 fs.unlinkSync(targetPath);
             return { success: true };
         }
+        else if (agent === 'antigravity') {
+            const targetDir = safeJoin(path.join(agentHome, '.gemini', 'config', 'agents'), subagentName);
+            if (fs.existsSync(targetDir))
+                fs.rmSync(targetDir, { recursive: true, force: true });
+            return { success: true };
+        }
         else if (agent === 'openclaw') {
             const targetDir = safeJoin(path.join(agentHome, '.openclaw'), subagentName);
             if (fs.existsSync(targetDir)) {
@@ -653,15 +707,17 @@ export function subagentContentMatches(installedDir, sourceDir) {
 // source of truth.
 /**
  * List subagents installed to a specific agent's home
- * Claude: scans ~/.claude/agents/{name}.md
+ * Claude/Gemini/Grok: scans ~/.{agent}/agents/{name}.md
  * Kimi: scans ~/.kimi-code/agents/{name}.yaml (+ sibling .system.md)
+ * Kiro: scans ~/.kiro/agents/{name}.json
  * OpenClaw: scans ~/.openclaw/{name}/AGENTS.md
  */
 export function listSubagentsForAgent(agentId, home) {
     const subagents = [];
-    if (agentId === 'claude' || agentId === 'grok') {
-        // Claude / Grok: flat .md files in agents/
-        const agentsDir = path.join(home, agentId === 'grok' ? '.grok' : '.claude', 'agents');
+    if (agentId === 'claude' || agentId === 'gemini' || agentId === 'grok') {
+        // Claude / Gemini / Grok: flat .md files in agents/
+        const agentsRoot = agentId === 'grok' ? '.grok' : agentId === 'gemini' ? '.gemini' : '.claude';
+        const agentsDir = path.join(home, agentsRoot, 'agents');
         if (!fs.existsSync(agentsDir))
             return subagents;
         for (const file of fs.readdirSync(agentsDir)) {
@@ -727,6 +783,20 @@ export function listSubagentsForAgent(agentId, home) {
             subagents.push({ name, path: filePath, files: [file], frontmatter });
         }
     }
+    else if (agentId === 'antigravity') {
+        const agentsDir = path.join(home, '.gemini', 'config', 'agents');
+        if (!fs.existsSync(agentsDir))
+            return subagents;
+        for (const entry of fs.readdirSync(agentsDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const filePath = path.join(agentsDir, entry.name, 'agent.md');
+            if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile())
+                continue;
+            const frontmatter = parseSubagentFrontmatter(filePath) ?? { name: entry.name, description: '' };
+            subagents.push({ name: entry.name, path: filePath, files: ['agent.md'], frontmatter });
+        }
+    }
     else if (agentId === 'copilot') {
         // Copilot: flat `<name>.agent.md` files under ~/.copilot/agents/
         const agentsDir = path.join(home, '.copilot', 'agents');
@@ -837,8 +907,9 @@ export function diffVersionSubagents(agent, version) {
         }
     }
     // Check what's installed
-    if (agent === 'claude' || agent === 'grok') {
-        const agentsDir = path.join(versionHome, agent === 'grok' ? '.grok' : '.claude', 'agents');
+    if (agent === 'claude' || agent === 'gemini' || agent === 'grok') {
+        const agentsRoot = agent === 'grok' ? '.grok' : agent === 'gemini' ? '.gemini' : '.claude';
+        const agentsDir = path.join(versionHome, agentsRoot, 'agents');
         if (fs.existsSync(agentsDir)) {
             for (const file of fs.readdirSync(agentsDir)) {
                 if (!file.endsWith('.md'))
@@ -875,6 +946,19 @@ export function diffVersionSubagents(agent, version) {
             }
         }
     }
+    else if (agent === 'antigravity') {
+        const agentsDir = path.join(versionHome, '.gemini', 'config', 'agents');
+        if (fs.existsSync(agentsDir)) {
+            for (const entry of fs.readdirSync(agentsDir, { withFileTypes: true })) {
+                if (!entry.isDirectory())
+                    continue;
+                if (!fs.existsSync(path.join(agentsDir, entry.name, 'agent.md')))
+                    continue;
+                if (!discovered.has(entry.name))
+                    orphans.push(entry.name);
+            }
+        }
+    }
     else if (agent === 'openclaw') {
         const openclawDir = path.join(versionHome, '.openclaw');
         if (fs.existsSync(openclawDir)) {
@@ -929,8 +1013,8 @@ export function removeSubagentFromVersion(agent, version, subagentName) {
     const stamp = new Date().toISOString().replace(/[:.]/g, '-');
     const trashDir = path.join(getTrashSubagentsDir(), agent, version, subagentName);
     try {
-        if (agent === 'claude' || agent === 'grok') {
-            const agentsRoot = agent === 'grok' ? '.grok' : '.claude';
+        if (agent === 'claude' || agent === 'gemini' || agent === 'grok') {
+            const agentsRoot = agent === 'grok' ? '.grok' : agent === 'gemini' ? '.gemini' : '.claude';
             const targetPath = path.join(versionHome, agentsRoot, 'agents', `${subagentName}.md`);
             if (fs.existsSync(targetPath)) {
                 fs.mkdirSync(trashDir, { recursive: true, mode: 0o700 });
@@ -958,6 +1042,13 @@ export function removeSubagentFromVersion(agent, version, subagentName) {
                 fs.renameSync(targetPath, path.join(trashDir, `${subagentName}.md.${stamp}`));
             }
         }
+        else if (agent === 'antigravity') {
+            const targetDir = path.join(versionHome, '.gemini', 'config', 'agents', subagentName);
+            if (fs.existsSync(targetDir)) {
+                fs.mkdirSync(trashDir, { recursive: true, mode: 0o700 });
+                fs.renameSync(targetDir, path.join(trashDir, stamp));
+            }
+        }
         else if (agent === 'copilot') {
             const targetPath = path.join(versionHome, '.copilot', 'agents', `${subagentName}.agent.md`);
             if (fs.existsSync(targetPath)) {

package/dist/lib/versions.js

@@ -2462,9 +2462,14 @@ export function syncResourcesToVersion(agent, version, selection, options = {})
     // reads only user + system layers (project excluded for the same defense
     // as commands/skills/hooks).
     const subagentsWriter = getWriter('subagents', agent);
-    const subagentsToSync = selection
+    const subagentsGate = supports(agent, 'subagents', version);
+    const subagentsRequested = selection
         ? resolveSelection(selection.subagents, available.subagents)
         : (subagentsWriter ? available.subagents : []);
+    const subagentsToSync = subagentsGate.ok ? subagentsRequested : [];
+    if (subagentsRequested.length > 0 && !subagentsGate.ok) {
+        console.warn(explainSkip(agent, 'subagents', subagentsGate, version) + ' -- skipped');
+    }
     if (subagentsToSync.length > 0 && subagentsWriter) {
         const r = subagentsWriter.write({ version, versionHome, selection: subagentsToSync, cwd });
         result.subagents.push(...r.synced);
@@ -2499,9 +2504,14 @@ export function syncResourcesToVersion(agent, version, selection, options = {})
     }
     // Sync workflows — dispatch through WRITERS.workflows.
     const workflowsWriter = getWriter('workflows', agent);
-    const workflowsToSync = selection
+    const workflowsGate = supports(agent, 'workflows', version);
+    const workflowsRequested = selection
         ? resolveSelection(selection.workflows, available.workflows)
         : (workflowsWriter ? available.workflows : []);
+    const workflowsToSync = workflowsGate.ok ? workflowsRequested : [];
+    if (workflowsRequested.length > 0 && !workflowsGate.ok) {
+        console.warn(explainSkip(agent, 'workflows', workflowsGate, version) + ' -- skipped');
+    }
     if (workflowsToSync.length > 0 && workflowsWriter) {
         const r = workflowsWriter.write({ version, versionHome, selection: workflowsToSync, cwd });
         result.workflows.push(...r.synced);

package/dist/lib/workflows.d.ts

@@ -263,6 +263,8 @@ export declare function resolveAllowedSubagents(available: string[], allowedAgen
 export declare function pruneStaleWorkflowSubagents(sharedAgentsDir: string, workflowSubagentFiles: string[], allowedStems: string[]): string[];
 /** Count subagent .md files in a workflow's subagents/ directory. */
 export declare function countWorkflowSubagents(workflowDir: string): number;
+/** Convert a canonical agents-cli workflow bundle into a Kimi flow skill. */
+export declare function transformWorkflowForKimi(workflowPath: string, name: string): string;
 /**
  * Resolve an `agents run <workflow>` reference.
  *
@@ -291,10 +293,10 @@ export declare function removeWorkflow(name: string): {
     success: boolean;
     error?: string;
 };
-/** List workflow names synced into a specific agent version home (at {versionHome}/workflows/). */
-export declare function listWorkflowsForAgent(_agent: AgentId, versionHome: string): string[];
+/** List workflow names synced into a specific agent version home. */
+export declare function listWorkflowsForAgent(agent: AgentId, versionHome: string): string[];
 /** Copy a workflow directory into a version home at {versionHome}/workflows/<name>/. */
-export declare function syncWorkflowToVersion(workflowPath: string, name: string, _agent: AgentId, versionHome: string): {
+export declare function syncWorkflowToVersion(workflowPath: string, name: string, agent: AgentId, versionHome: string): {
     success: boolean;
     error?: string;
 };