@phnx-labs/agents-cli 1.20.51 → 1.20.53

package/dist/lib/state.js

@@ -89,6 +89,7 @@ const TEAMS_AGENTS_DIR = path.join(HISTORY_DIR, 'teams', 'agents');
 const BACKUPS_DIR = path.join(HISTORY_DIR, 'backups');
 const TRASH_DIR = path.join(HISTORY_DIR, 'trash');
 const MAILBOX_DIR = path.join(HISTORY_DIR, 'mailbox');
+const FEED_DIR = path.join(HISTORY_DIR, 'feed');
 // Cache bucket (regenerable).
 const SHIMS_DIR = path.join(CACHE_DIR, 'shims');
 const HOOK_SHIMS_DIR = path.join(SHIMS_DIR, 'hooks');
@@ -313,6 +314,8 @@ export function getProjectRoutinesDir(cwd = process.cwd()) {
 export function getRunsDir() { return RUNS_DIR; }
 /** Root for per-agent mailboxes (~/.agents/.history/mailbox/). */
 export function getMailboxRootDir() { return MAILBOX_DIR; }
+/** Root for open-block feed records (~/.agents/.history/feed/). */
+export function getFeedDir() { return FEED_DIR; }
 /** Path to installed agent CLI binaries (~/.agents/.history/versions/). */
 export function getVersionsDir() { return VERSIONS_DIR; }
 /** Path to version-switching shim scripts (~/.agents/.cache/shims/). */
@@ -569,25 +572,35 @@ function writeIfChanged(filePath, content) {
 /**
  * Partition the in-memory Meta across three files by sync-domain:
  *   - central  `~/.agents/agents.yaml`             — portable, everything else
- *   - device   `~/.agents/devices/<machine>/agents.yaml` — `agents:` pins (per-device)
+ *   - device   `~/.agents/devices/<machine>/agents.yaml` — `agents:` pins +
+ *              `defaultBrowserProfile:` (both per-device)
  *   - history  `~/.agents/.history/version-resources.json` — `versions:` (machine-local)
  * All callers funnel through writeMeta → here, so nothing else changes. Empty
  * `agents:` / `versions:` are not written (no empty committed files).
  */
 function writeMetaUnlocked(meta) {
-    const { agents, versions, ...central } = meta;
+    const { agents, versions, defaultBrowserProfile, ...central } = meta;
     // Write the machine-local files FIRST, then strip central — so a crash mid-write
     // never removes pins/versions from central before they're persisted elsewhere.
     const devicePath = getDeviceMetaPath();
-    if (agents && Object.keys(agents).length > 0) {
+    const hasAgents = !!agents && Object.keys(agents).length > 0;
+    const hasDefaultBrowser = !!defaultBrowserProfile;
+    if (hasAgents || hasDefaultBrowser) {
+        // Device-local doc carries `agents:` pins and `defaultBrowserProfile:` — both
+        // are per-machine and must never land in central agents.yaml (which syncs).
+        const deviceDoc = {};
+        if (hasAgents)
+            deviceDoc.agents = agents;
+        if (hasDefaultBrowser)
+            deviceDoc.defaultBrowserProfile = defaultBrowserProfile;
         fs.mkdirSync(path.dirname(devicePath), { recursive: true });
-        writeIfChanged(devicePath, META_HEADER + yaml.stringify({ agents }));
+        writeIfChanged(devicePath, META_HEADER + yaml.stringify(deviceDoc));
     }
     else if (fs.existsSync(devicePath)) {
-        // Every pin was cleared. Persist the emptied map instead of skipping the
-        // write — otherwise the stale device file survives and overlayMachineLocal
-        // re-applies the removed pin on the next read, leaving a dangling default
-        // (e.g. a launcher pointing at a version that was just uninstalled).
+        // Every device-local value was cleared. Persist the emptied doc instead of
+        // skipping the write — otherwise the stale device file survives and
+        // overlayMachineLocal re-applies the removed pin/default on the next read,
+        // leaving a dangling value (e.g. a default pointing at a deleted profile).
         writeIfChanged(devicePath, META_HEADER + yaml.stringify({ agents: {} }));
     }
     if (versions && Object.keys(versions).length > 0) {
@@ -602,6 +615,8 @@ function writeMetaUnlocked(meta) {
  * Overlay this machine's local state onto a central-portable Meta:
  *   - `agents:` from the device file (device wins; the union both preserves the
  *     one-level merge and self-heals a pre-migration central that still has pins)
+ *   - `defaultBrowserProfile:` from the device file (device is the sole source;
+ *     the field is stripped from central on write, so nothing to merge against)
  *   - `versions:` from the history JSON (wholesale replace; falls back to
  *     whatever central carried when the history file doesn't exist yet)
  */
@@ -612,6 +627,8 @@ function overlayMachineLocal(meta) {
             const dm = yaml.parse(fs.readFileSync(devicePath, 'utf-8'));
             if (dm?.agents)
                 meta.agents = { ...meta.agents, ...dm.agents };
+            if (dm?.defaultBrowserProfile)
+                meta.defaultBrowserProfile = dm.defaultBrowserProfile;
         }
         catch { /* ignore malformed device file */ }
     }

package/dist/lib/subagents.d.ts

@@ -56,6 +56,57 @@ export declare function transformSubagentForClaude(subagentDir: string): string;
  * See https://docs.factory.ai/cli/configuration/custom-droids.
  */
 export declare function transformSubagentForDroid(subagentDir: string): string;
+/**
+ * Transform a subagent into an OpenCode agent markdown file.
+ *
+ * OpenCode loads agents from ~/.config/opencode/agents/*.md (global) with
+ * YAML frontmatter (description required; mode: subagent for invocable
+ * subagents) and a prompt body. File stem becomes the agent name.
+ * https://opencode.ai/docs/agents/
+ */
+export declare function transformSubagentForOpenCode(subagentDir: string): string;
+/** Managed parent agent file for Kimi (underscore prefix avoids clobbering a user subagent named agents-cli). */
+export declare const KIMI_SUBAGENTS_PARENT_FILE = "_agents-cli.yaml";
+export interface KimiSubagentFiles {
+    /** Agent YAML content (uses system_prompt_path, not inline system_prompt). */
+    yaml: string;
+    /** Markdown body written next to the YAML and referenced by system_prompt_path. */
+    systemPrompt: string;
+    /** Sibling prompt filename, e.g. `reviewer.system.md`. */
+    systemPromptFileName: string;
+}
+/**
+ * Transform a subagent into Kimi Code agent files.
+ *
+ * Kimi's schema (agentspec) only accepts `system_prompt_path` (path relative to
+ * the agent YAML) — there is no inline `system_prompt` key. We write:
+ *   ~/.kimi-code/agents/<name>.yaml          — agent YAML
+ *   ~/.kimi-code/agents/<name>.system.md     — system prompt body
+ * plus a managed parent `_agents-cli.yaml` that lists them under agent.subagents
+ * for `kimi --agent-file …/_agents-cli.yaml`.
+ * https://moonshotai.github.io/kimi-cli/en/customization/agents.html
+ */
+export declare function transformSubagentForKimi(subagentDir: string, fileBaseName: string): KimiSubagentFiles;
+/**
+ * Build the managed parent agent YAML that declares all installed subagents
+ * so `kimi --agent-file ~/.kimi-code/agents/_agents-cli.yaml` can launch them.
+ */
+export declare function buildKimiSubagentsParentYaml(entries: Array<{
+    name: string;
+    description: string;
+    relativePath: string;
+}>): string;
+/** Write a Kimi subagent YAML + sibling system-prompt md into agentsDir. */
+export declare function writeKimiSubagentFiles(agentsDir: string, subagentDir: string, name: string): void;
+/**
+ * Transform a subagent into a Codex custom-agent TOML file.
+ *
+ * Codex loads standalone TOML under ~/.codex/agents/*.toml. Required fields:
+ * name, description, developer_instructions. Optional model maps from our
+ * frontmatter when present.
+ * https://developers.openai.com/codex/subagents (custom agents section)
+ */
+export declare function transformSubagentForCodex(subagentDir: string): string;
 /**
  * Sync a subagent to an OpenClaw workspace
  * Copies full directory, renames AGENT.md to AGENTS.md
@@ -85,6 +136,7 @@ export declare function subagentContentMatches(installedDir: string, sourceDir:
 /**
  * List subagents installed to a specific agent's home
  * Claude: scans ~/.claude/agents/{name}.md
+ * Kimi: scans ~/.kimi-code/agents/{name}.yaml (+ sibling .system.md)
  * OpenClaw: scans ~/.openclaw/{name}/AGENTS.md
  */
 export declare function listSubagentsForAgent(agentId: AgentId, home: string): InstalledSubagent[];

package/dist/lib/subagents.js

@@ -262,6 +262,153 @@ export function transformSubagentForDroid(subagentDir) {
     }
     return result;
 }
+/**
+ * Transform a subagent into an OpenCode agent markdown file.
+ *
+ * OpenCode loads agents from ~/.config/opencode/agents/*.md (global) with
+ * YAML frontmatter (description required; mode: subagent for invocable
+ * subagents) and a prompt body. File stem becomes the agent name.
+ * https://opencode.ai/docs/agents/
+ */
+export function transformSubagentForOpenCode(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 fm = {
+        description: frontmatter.description,
+        mode: 'subagent',
+    };
+    if (frontmatter.model)
+        fm.model = frontmatter.model;
+    let systemPrompt = 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();
+        systemPrompt += `\n\n## ${title}\n\n${content}`;
+    }
+    return `---\n${yaml.stringify(fm).trim()}\n---\n\n${systemPrompt}\n`;
+}
+/** Managed parent agent file for Kimi (underscore prefix avoids clobbering a user subagent named agents-cli). */
+export const KIMI_SUBAGENTS_PARENT_FILE = '_agents-cli.yaml';
+/**
+ * Transform a subagent into Kimi Code agent files.
+ *
+ * Kimi's schema (agentspec) only accepts `system_prompt_path` (path relative to
+ * the agent YAML) — there is no inline `system_prompt` key. We write:
+ *   ~/.kimi-code/agents/<name>.yaml          — agent YAML
+ *   ~/.kimi-code/agents/<name>.system.md     — system prompt body
+ * plus a managed parent `_agents-cli.yaml` that lists them under agent.subagents
+ * for `kimi --agent-file …/_agents-cli.yaml`.
+ * https://moonshotai.github.io/kimi-cli/en/customization/agents.html
+ */
+export function transformSubagentForKimi(subagentDir, fileBaseName) {
+    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}`);
+    }
+    let systemPrompt = 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();
+        systemPrompt += `\n\n## ${title}\n\n${content}`;
+    }
+    const systemPromptFileName = `${fileBaseName}.system.md`;
+    const doc = {
+        version: 1,
+        agent: {
+            extend: 'default',
+            name: frontmatter.name,
+            description: frontmatter.description,
+            system_prompt_path: `./${systemPromptFileName}`,
+        },
+    };
+    if (frontmatter.model) {
+        doc.agent.model = frontmatter.model;
+    }
+    return {
+        yaml: yaml.stringify(doc),
+        systemPrompt,
+        systemPromptFileName,
+    };
+}
+/**
+ * Build the managed parent agent YAML that declares all installed subagents
+ * so `kimi --agent-file ~/.kimi-code/agents/_agents-cli.yaml` can launch them.
+ */
+export function buildKimiSubagentsParentYaml(entries) {
+    const subagents = {};
+    for (const e of entries) {
+        subagents[e.name] = { path: e.relativePath, description: e.description };
+    }
+    return yaml.stringify({
+        version: 1,
+        agent: {
+            extend: 'default',
+            name: 'agents-cli',
+            description: 'Managed parent agent listing agents-cli synced subagents',
+            subagents,
+        },
+    });
+}
+/** Write a Kimi subagent YAML + sibling system-prompt md into agentsDir. */
+export function writeKimiSubagentFiles(agentsDir, subagentDir, name) {
+    const { yaml: yml, systemPrompt, systemPromptFileName } = transformSubagentForKimi(subagentDir, name);
+    fs.mkdirSync(agentsDir, { recursive: true });
+    fs.writeFileSync(safeJoin(agentsDir, `${name}.yaml`), yml);
+    fs.writeFileSync(safeJoin(agentsDir, systemPromptFileName), systemPrompt);
+}
+/**
+ * Transform a subagent into a Codex custom-agent TOML file.
+ *
+ * Codex loads standalone TOML under ~/.codex/agents/*.toml. Required fields:
+ * name, description, developer_instructions. Optional model maps from our
+ * frontmatter when present.
+ * https://developers.openai.com/codex/subagents (custom agents section)
+ */
+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}`;
+    }
+    // Escape TOML multi-line string (""") content — only """ needs escaping.
+    const safeInstructions = instructions.replace(/"""/g, '\\"""');
+    const safeName = frontmatter.name.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    const safeDesc = frontmatter.description.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    let toml = `name = "${safeName}"\n`;
+    toml += `description = "${safeDesc}"\n`;
+    if (frontmatter.model) {
+        const safeModel = String(frontmatter.model).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        toml += `model = "${safeModel}"\n`;
+    }
+    toml += `developer_instructions = """\n${safeInstructions}\n"""\n`;
+    return toml;
+}
 /**
  * Sync a subagent to an OpenClaw workspace
  * Copies full directory, renames AGENT.md to AGENTS.md
@@ -291,9 +438,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') {
-        // Claude: flatten to single .md file
-        const agentsDir = path.join(agentHome, '.claude', 'agents');
+    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 (!fs.existsSync(agentsDir)) {
             fs.mkdirSync(agentsDir, { recursive: true });
         }
@@ -306,6 +454,44 @@ export function installSubagentToAgent(subagentDir, subagentName, agent, agentHo
             return { success: false, error: String(err) };
         }
     }
+    else if (agent === 'codex') {
+        // Codex: standalone TOML under ~/.codex/agents/<name>.toml
+        const agentsDir = path.join(agentHome, '.codex', 'agents');
+        if (!fs.existsSync(agentsDir)) {
+            fs.mkdirSync(agentsDir, { recursive: true });
+        }
+        try {
+            const toml = transformSubagentForCodex(subagentDir);
+            fs.writeFileSync(safeJoin(agentsDir, `${subagentName}.toml`), toml);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
+    else if (agent === 'kimi') {
+        // Kimi: YAML + sibling system-prompt md under ~/.kimi-code/agents/
+        try {
+            writeKimiSubagentFiles(path.join(agentHome, '.kimi-code', 'agents'), subagentDir, subagentName);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
+    else if (agent === 'opencode') {
+        // OpenCode: markdown agents under ~/.config/opencode/agents/
+        const agentsDir = path.join(agentHome, '.config', 'opencode', 'agents');
+        if (!fs.existsSync(agentsDir))
+            fs.mkdirSync(agentsDir, { recursive: true });
+        try {
+            fs.writeFileSync(safeJoin(agentsDir, `${subagentName}.md`), transformSubagentForOpenCode(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);
@@ -321,13 +507,37 @@ export function installSubagentToAgent(subagentDir, subagentName, agent, agentHo
  */
 export function removeSubagentFromAgent(subagentName, agent, agentHome) {
     try {
-        if (agent === 'claude') {
-            const targetPath = safeJoin(path.join(agentHome, '.claude', 'agents'), `${subagentName}.md`);
+        if (agent === 'claude' || agent === 'grok') {
+            const agentsRoot = agent === 'grok' ? '.grok' : '.claude';
+            const targetPath = safeJoin(path.join(agentHome, agentsRoot, 'agents'), `${subagentName}.md`);
+            if (fs.existsSync(targetPath)) {
+                fs.unlinkSync(targetPath);
+            }
+            return { success: true };
+        }
+        else if (agent === 'codex') {
+            const targetPath = safeJoin(path.join(agentHome, '.codex', 'agents'), `${subagentName}.toml`);
             if (fs.existsSync(targetPath)) {
                 fs.unlinkSync(targetPath);
             }
             return { success: true };
         }
+        else if (agent === 'kimi') {
+            const agentsDir = path.join(agentHome, '.kimi-code', 'agents');
+            const targetPath = safeJoin(agentsDir, `${subagentName}.yaml`);
+            const promptPath = safeJoin(agentsDir, `${subagentName}.system.md`);
+            if (fs.existsSync(targetPath))
+                fs.unlinkSync(targetPath);
+            if (fs.existsSync(promptPath))
+                fs.unlinkSync(promptPath);
+            return { success: true };
+        }
+        else if (agent === 'opencode') {
+            const targetPath = safeJoin(path.join(agentHome, '.config', 'opencode', 'agents'), `${subagentName}.md`);
+            if (fs.existsSync(targetPath))
+                fs.unlinkSync(targetPath);
+            return { success: true };
+        }
         else if (agent === 'openclaw') {
             const targetDir = safeJoin(path.join(agentHome, '.openclaw'), subagentName);
             if (fs.existsSync(targetDir)) {
@@ -373,13 +583,14 @@ export function subagentContentMatches(installedDir, sourceDir) {
 /**
  * List subagents installed to a specific agent's home
  * Claude: scans ~/.claude/agents/{name}.md
+ * Kimi: scans ~/.kimi-code/agents/{name}.yaml (+ sibling .system.md)
  * OpenClaw: scans ~/.openclaw/{name}/AGENTS.md
  */
 export function listSubagentsForAgent(agentId, home) {
     const subagents = [];
-    if (agentId === 'claude') {
-        // Claude: flat .md files in agents/
-        const agentsDir = path.join(home, '.claude', 'agents');
+    if (agentId === 'claude' || agentId === 'grok') {
+        // Claude / Grok: flat .md files in agents/
+        const agentsDir = path.join(home, agentId === 'grok' ? '.grok' : '.claude', 'agents');
         if (!fs.existsSync(agentsDir))
             return subagents;
         for (const file of fs.readdirSync(agentsDir)) {
@@ -400,6 +611,51 @@ export function listSubagentsForAgent(agentId, home) {
             });
         }
     }
+    else if (agentId === 'kimi') {
+        // Kimi: flat YAML under .kimi-code/agents/ (exclude managed parent _*.yaml)
+        const agentsDir = path.join(home, '.kimi-code', 'agents');
+        if (!fs.existsSync(agentsDir))
+            return subagents;
+        for (const file of fs.readdirSync(agentsDir)) {
+            if (!file.endsWith('.yaml') || file.startsWith('_'))
+                continue;
+            const filePath = path.join(agentsDir, file);
+            if (!fs.statSync(filePath).isFile())
+                continue;
+            const name = file.replace(/\.yaml$/, '');
+            let description = '';
+            try {
+                const parsed = yaml.parse(fs.readFileSync(filePath, 'utf-8'));
+                description = parsed?.agent?.description ?? '';
+            }
+            catch { /* leave description empty */ }
+            const files = [file];
+            const promptFile = `${name}.system.md`;
+            if (fs.existsSync(path.join(agentsDir, promptFile)))
+                files.push(promptFile);
+            subagents.push({
+                name,
+                path: filePath,
+                files,
+                frontmatter: { name, description },
+            });
+        }
+    }
+    else if (agentId === 'opencode') {
+        const agentsDir = path.join(home, '.config', 'opencode', '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 === 'openclaw') {
         // OpenClaw: directories with AGENTS.md
         const openclawDir = path.join(home, '.openclaw');
@@ -462,8 +718,8 @@ export function diffVersionSubagents(agent, version) {
         }
     }
     // Check what's installed
-    if (agent === 'claude') {
-        const agentsDir = path.join(versionHome, '.claude', 'agents');
+    if (agent === 'claude' || agent === 'grok') {
+        const agentsDir = path.join(versionHome, agent === 'grok' ? '.grok' : '.claude', 'agents');
         if (fs.existsSync(agentsDir)) {
             for (const file of fs.readdirSync(agentsDir)) {
                 if (!file.endsWith('.md'))
@@ -475,6 +731,31 @@ export function diffVersionSubagents(agent, version) {
             }
         }
     }
+    else if (agent === 'kimi') {
+        const agentsDir = path.join(versionHome, '.kimi-code', 'agents');
+        if (fs.existsSync(agentsDir)) {
+            for (const file of fs.readdirSync(agentsDir)) {
+                if (!file.endsWith('.yaml') || file.startsWith('_'))
+                    continue;
+                const name = path.basename(file, '.yaml');
+                if (!discovered.has(name)) {
+                    orphans.push(name);
+                }
+            }
+        }
+    }
+    else if (agent === 'opencode') {
+        const agentsDir = path.join(versionHome, '.config', 'opencode', '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 === 'openclaw') {
         const openclawDir = path.join(versionHome, '.openclaw');
         if (fs.existsSync(openclawDir)) {
@@ -516,8 +797,30 @@ 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') {
-            const targetPath = path.join(versionHome, '.claude', 'agents', `${subagentName}.md`);
+        if (agent === 'claude' || agent === 'grok') {
+            const agentsRoot = agent === 'grok' ? '.grok' : '.claude';
+            const targetPath = path.join(versionHome, agentsRoot, '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 === 'kimi') {
+            const agentsDir = path.join(versionHome, '.kimi-code', 'agents');
+            const yamlPath = path.join(agentsDir, `${subagentName}.yaml`);
+            const promptPath = path.join(agentsDir, `${subagentName}.system.md`);
+            if (fs.existsSync(yamlPath) || fs.existsSync(promptPath)) {
+                fs.mkdirSync(trashDir, { recursive: true, mode: 0o700 });
+                if (fs.existsSync(yamlPath)) {
+                    fs.renameSync(yamlPath, path.join(trashDir, `${subagentName}.yaml.${stamp}`));
+                }
+                if (fs.existsSync(promptPath)) {
+                    fs.renameSync(promptPath, path.join(trashDir, `${subagentName}.system.md.${stamp}`));
+                }
+            }
+        }
+        else if (agent === 'opencode') {
+            const targetPath = path.join(versionHome, '.config', 'opencode', 'agents', `${subagentName}.md`);
             if (fs.existsSync(targetPath)) {
                 fs.mkdirSync(trashDir, { recursive: true, mode: 0o700 });
                 fs.renameSync(targetPath, path.join(trashDir, `${subagentName}.md.${stamp}`));

package/dist/lib/teams/agents.js

@@ -1693,6 +1693,7 @@ export class AgentManager {
         ];
         if (model)
             args.push('--model', model);
+        args.push('--env', 'AGENTS_RUNTIME=teams');
         return args;
     }
     buildCommand(agentType, prompt, mode, model, cwd = null, sessionId = null, effort = 'medium', version = null, profileName = null) {
@@ -1704,9 +1705,11 @@ export class AgentManager {
         ];
         if (cwd)
             cmd.push('--cwd', cwd);
-        // Pin Claude's session UUID to our agent_id so its session file lands at
-        // ~/.claude/projects/.../<agent_id>.jsonl — unified identity for status polling.
-        if (agentType === 'claude' && sessionId) {
+        // Pin the session UUID to our agent_id so buildExecEnv keys
+        // AGENTS_MAILBOX_DIR by the same id mailboxIdForActiveSession returns.
+        // Claude also forwards --session-id to its CLI (unified identity);
+        // other agents ignore the flag but still get the correct mailbox dir.
+        if (sessionId) {
             cmd.push('--session-id', sessionId);
         }
         // Claude: grant access to the teammate's working directory.

package/dist/lib/teams/worktree.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Check if `dir` is inside a git repository (**async, worktree-correct**).
+ *
+ * Shells out to `git rev-parse --git-dir`, so it returns true from any
+ * subdirectory and for linked worktrees. Distinct from the synchronous,
+ * root-only `isGitRepo` in `lib/git.ts` (a `.git`-existence check): different
+ * semantics, so the two are intentionally **not** merged.
+ */
 export declare function isGitRepo(dir: string): Promise<boolean>;
 export declare function getGitRoot(dir: string): Promise<string>;
 /**

package/dist/lib/teams/worktree.js

@@ -11,6 +11,14 @@ import * as path from 'path';
 import { safeJoin } from '../paths.js';
 const execFileAsync = promisify(execFile);
 const WORKTREE_NAME_RE = /^[A-Za-z0-9_-]+$/;
+/**
+ * Check if `dir` is inside a git repository (**async, worktree-correct**).
+ *
+ * Shells out to `git rev-parse --git-dir`, so it returns true from any
+ * subdirectory and for linked worktrees. Distinct from the synchronous,
+ * root-only `isGitRepo` in `lib/git.ts` (a `.git`-existence check): different
+ * semantics, so the two are intentionally **not** merged.
+ */
 export async function isGitRepo(dir) {
     try {
         await execFileAsync('git', ['rev-parse', '--git-dir'], { cwd: dir });

package/dist/lib/types.d.ts

@@ -7,7 +7,7 @@
  */
 import type { CloudProviderId } from './cloud/types.js';
 /** Unique identifier for a supported AI coding agent. */
-export type AgentId = 'claude' | 'codex' | 'gemini' | 'cursor' | 'opencode' | 'openclaw' | 'copilot' | 'amp' | 'kiro' | 'goose' | 'antigravity' | 'grok' | 'kimi' | 'droid';
+export type AgentId = 'claude' | 'codex' | 'gemini' | 'cursor' | 'opencode' | 'openclaw' | 'copilot' | 'amp' | 'kiro' | 'goose' | 'antigravity' | 'grok' | 'kimi' | 'droid' | 'hermes' | 'forge';
 /** How `agents run <agent>` chooses an installed version when none is pinned. */
 export type RunStrategy = 'pinned' | 'available' | 'balanced';
 /** Per-agent run strategy config. */
@@ -148,6 +148,12 @@ export interface AgentConfig {
         subagents: Capability;
         rules: RulesCapability;
         workflows: Capability;
+        /**
+         * Portable knowledge-store memory (`agents memory` / ~/.agents/memory/).
+         * Distinct from `rules` (instructions). When true, sync fans facts into
+         * the agent version home (see memoryTargetDir).
+         */
+        memory: Capability;
         /**
          * Permission modes this agent natively supports. Modes outside this set
          * are gated by buildExecCommand: `auto` silently degrades to `edit`,
@@ -177,7 +183,7 @@ export type RulesCapability = false | {
     file: string;
 };
 /** Names of every gateable capability on AgentConfig. */
-export type CapabilityName = 'hooks' | 'mcp' | 'mcpHttp' | 'mcpHeaders' | 'allowlist' | 'skills' | 'commands' | 'plugins' | 'subagents' | 'rules' | 'workflows';
+export type CapabilityName = 'hooks' | 'mcp' | 'mcpHttp' | 'mcpHeaders' | 'allowlist' | 'skills' | 'commands' | 'plugins' | 'subagents' | 'rules' | 'workflows' | 'memory';
 /**
  * Permission modes controlling agent autonomy.
  *   plan  read-only investigation; no writes, no shell side-effects
@@ -516,6 +522,8 @@ export interface DiscoveredPlugin {
     commands: string[];
     /** Subagent .md files in the plugin's agents/ directory (names without extension). */
     agentDefs: string[];
+    /** Memory fact basenames from the plugin's memory/ directory (without .md). */
+    memory: string[];
     /** Executable files in the plugin's bin/ directory. */
     bin: string[];
     /** MCP server names parsed from .mcp.json. */
@@ -652,6 +660,16 @@ export interface Meta {
      * lives separately in ~/.agents/.cache/browser/<profile>/.
      */
     browser?: Record<string, BrowserProfileConfig>;
+    /**
+     * Device-local pointer: the browser profile `agents browser start` resolves to
+     * when no `--profile` is passed (and what an explicit `--profile default`
+     * re-points to). Stored per-machine in `~/.agents/devices/<machine>/agents.yaml`,
+     * NOT central — the target profile may carry machine-local logins, so the choice
+     * must not ride `agents repo push/pull` to other machines. Unset = auto-detect an
+     * installed Chromium-family browser (legacy behavior). Set via
+     * `agents browser profiles set-default <name>`.
+     */
+    defaultBrowserProfile?: string;
     /**
      * Agent-host registry keyed by host name (`agents hosts`). Portable user
      * config synced with `agents repo push/pull`. For `ssh-config` hosts this is