@agentxm/client-core 0.11.2 → 0.11.3

package/dist/src/unstable/agent-capabilities/catalog.generated.js

@@ -10,6 +10,8 @@ export const AGENT_IDS = [
     "cursor",
     "gemini-cli",
     "github-copilot",
+    "opencode",
+    "pi",
     "windsurf",
 ];
 /** @experimental This API is unstable and may change without notice. */
@@ -42,9 +44,10 @@ export const AGENTS = [
             directory: ".claude/skills",
         },
         commands: {
-            support: "standard",
+            support: "bridged",
+            notes: "Custom slash commands are Markdown prompt files under .claude/commands. Recorded as bridged because commands have no industry spec standard.\n",
             sources: ["https://docs.claude.com/en/docs/claude-code/slash-commands"],
-            lastVerified: "2026-05-16",
+            lastVerified: "2026-05-18",
             scopes: ["user", "project"],
             directory: ".claude/commands",
         },
@@ -54,6 +57,39 @@ export const AGENTS = [
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio", "http", "sse"],
+            config: {
+                serversKey: "mcpServers",
+                nativeEnabled: false,
+                targets: [
+                    {
+                        scope: "project",
+                        path: ".mcp.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    typeField: {
+                        name: "type",
+                        value: "stdio",
+                    },
+                    command: "split",
+                    envKey: "env",
+                },
+                remote: {
+                    typeField: {
+                        name: "type",
+                        value: {
+                            "streamable-http": "http",
+                            sse: "sse",
+                        },
+                    },
+                    urlKey: {
+                        "streamable-http": "url",
+                        sse: "url",
+                    },
+                    headersKey: "headers",
+                },
+            },
         },
         subagents: {
             support: "bridged",
@@ -69,6 +105,63 @@ export const AGENTS = [
             files: ["CLAUDE.md"],
             nestedDiscovery: true,
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://docs.claude.com/en/docs/claude-code/iam",
+                "https://docs.claude.com/en/docs/claude-code/settings",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            mechanism: ["config-file"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/.claude/settings.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".claude/settings.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".claude/settings.local.json",
+                    format: "json",
+                    gitignored: true,
+                },
+            ],
+            grammar: {
+                style: "tool-call",
+                example: "Bash(axm:*)",
+                notes: "Tool(specifier) with * wildcards. Evaluated deny > ask > allow (first match wins). Settings merge across scopes rather than override.\n",
+            },
+            grants: {
+                shell: {
+                    target: "~/.claude/settings.json",
+                    patch: {
+                        permissions: {
+                            allow: ["Bash(${tool}:*)"],
+                        },
+                    },
+                },
+                filesystem: {
+                    target: "~/.claude/settings.json",
+                    patch: {
+                        permissions: {
+                            allow: [
+                                "Read(${workspaceRoot}/**)",
+                                "Write(${workspaceRoot}/**)",
+                                "Edit(${workspaceRoot}/**)",
+                            ],
+                        },
+                    },
+                },
+            },
+        },
     },
     {
         id: "codex",
@@ -83,12 +176,73 @@ export const AGENTS = [
                 url: "https://developers.openai.com/codex",
             },
         ],
+        skills: {
+            support: "standard",
+            notes: "Reads SKILL.md skills from repository (.agents/skills) and user (~/.agents/skills) locations with progressive disclosure, using the cross-tool Agent Skills convention rather than a .codex/ path.\n",
+            sources: ["https://developers.openai.com/codex/skills"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".agents/skills",
+        },
+        commands: {
+            support: "bridged",
+            notes: "Custom prompts are user-scope Markdown slash commands in ~/.codex/prompts. Deprecated by OpenAI in favor of skills for reusable instructions, and there is no project-scoped command directory.\n",
+            sources: [
+                "https://developers.openai.com/codex/custom-prompts",
+                "https://developers.openai.com/codex/cli/slash-commands",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user"],
+            directory: "~/.codex/prompts",
+        },
         mcp: {
             support: "standard",
             sources: ["https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers"],
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio", "http"],
+            config: {
+                serversKey: "mcp_servers",
+                nativeEnabled: true,
+                targets: [
+                    {
+                        scope: "project",
+                        path: ".codex/config.toml",
+                        format: "toml",
+                    },
+                    {
+                        scope: "user",
+                        path: "~/.codex/config.toml",
+                        format: "toml",
+                    },
+                ],
+                stdio: {
+                    command: "split",
+                    envKey: "env",
+                },
+                remote: {
+                    typeField: {
+                        name: "type",
+                        value: {
+                            "streamable-http": "streamable-http",
+                            sse: "sse",
+                        },
+                    },
+                    urlKey: {
+                        "streamable-http": "url",
+                        sse: "url",
+                    },
+                    headersKey: "http_headers",
+                },
+                transform: "codex-toml",
+            },
+        },
+        subagents: {
+            support: "bridged",
+            notes: "Custom agents are standalone TOML files under .codex/agents (project) or ~/.codex/agents (user); a custom agent overrides a built-in of the same name.\n",
+            sources: ["https://developers.openai.com/codex/subagents"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
         },
         instructions: {
             support: "standard",
@@ -98,6 +252,79 @@ export const AGENTS = [
             files: ["AGENTS.md"],
             nestedDiscovery: true,
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://developers.openai.com/codex/config-reference",
+                "https://developers.openai.com/codex/config-advanced",
+                "https://developers.openai.com/codex/security",
+                "https://developers.openai.com/codex/rules",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            mechanism: ["config-file", "cli-flag"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/.codex/config.toml",
+                    format: "toml",
+                    gitignored: false,
+                },
+                {
+                    scope: "user",
+                    path: "~/.codex/rules/${tool}.rules",
+                    format: "starlark",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "starlark-rule",
+                example: 'prefix_rule(pattern=["axm"], decision="allow")',
+                notes: "Per-command allowlisting is Starlark prefix_rule() in ~/.codex/rules/*.rules. Sandbox and approval mode live separately in config.toml. Most restrictive match wins (forbidden > prompt > allow).\n",
+            },
+            prerequisites: [
+                {
+                    key: "sandbox_mode",
+                    value: "workspace-write",
+                    scope: "user",
+                    note: "Required to grant project write access.",
+                },
+                {
+                    key: "approval_policy",
+                    value: "never",
+                    scope: "user",
+                    note: "Suppresses approval prompts.",
+                },
+            ],
+            cliFlags: [
+                {
+                    flag: "--full-auto",
+                    note: "Equivalent one-shot bypass of prompts and sandbox restrictions.",
+                },
+                {
+                    flag: "--sandbox workspace-write",
+                },
+                {
+                    flag: "--ask-for-approval never",
+                },
+            ],
+            grants: {
+                shell: {
+                    target: "~/.codex/rules/${tool}.rules",
+                    template: 'prefix_rule(\n    pattern = ["${tool}"],\n    decision = "allow",\n    justification = "${tool} CLI trusted in this workspace.",\n)\n',
+                },
+                filesystem: {
+                    target: "~/.codex/config.toml",
+                    patch: {
+                        sandbox_mode: "workspace-write",
+                        sandbox_workspace_write: {
+                            writable_roots: ["${workspaceRoot}"],
+                            network_access: true,
+                        },
+                    },
+                },
+            },
+        },
     },
     {
         id: "cursor",
@@ -112,12 +339,60 @@ export const AGENTS = [
                 url: "https://docs.cursor.com",
             },
         ],
+        skills: {
+            support: "standard",
+            notes: "Cursor 2.4 added Agent Skills (SKILL.md) across the editor and the cursor-agent CLI; it also loads .claude/skills and .codex/skills for cross-tool compatibility.\n",
+            sources: ["https://cursor.com/docs/context/skills", "https://cursor.com/changelog/2-4"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".cursor/skills",
+        },
+        commands: {
+            support: "bridged",
+            notes: "Custom commands are Markdown prompt files under .cursor/commands (project) or ~/.cursor/commands (user); documented as a beta feature.\n",
+            sources: [
+                "https://docs.cursor.com/en/agent/chat/commands",
+                "https://cursor.com/changelog/1-6",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".cursor/commands",
+        },
         mcp: {
             support: "standard",
             sources: ["https://docs.cursor.com/advanced/model-context-protocol"],
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio", "http", "sse"],
+            config: {
+                serversKey: "mcpServers",
+                nativeEnabled: false,
+                targets: [
+                    {
+                        scope: "project",
+                        path: ".cursor/mcp.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    command: "split",
+                    envKey: "env",
+                },
+                remote: {
+                    urlKey: {
+                        "streamable-http": "url",
+                        sse: "url",
+                    },
+                    headersKey: "headers",
+                },
+            },
+        },
+        subagents: {
+            support: "bridged",
+            notes: "Custom subagents are Markdown files with YAML frontmatter under .cursor/agents (project) or ~/.cursor/agents (user); added in Cursor 2.4.\n",
+            sources: ["https://cursor.com/docs/subagents", "https://cursor.com/changelog/2-4"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
         },
         instructions: {
             support: "standard",
@@ -134,6 +409,96 @@ export const AGENTS = [
             scopes: ["project"],
             directory: ".cursor/rules",
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://cursor.com/docs/reference/permissions",
+                "https://cursor.com/docs/reference/sandbox",
+                "https://cursor.com/docs/agent/tools/terminal",
+                "https://cursor.com/docs/cli/reference/permissions",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            mechanism: ["config-file", "ui-only", "cli-flag"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/.cursor/permissions.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "user",
+                    path: "~/.cursor/sandbox.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".cursor/sandbox.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "user",
+                    path: "~/.cursor/cli-config.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".cursor/cli.json",
+                    format: "json",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "prefix",
+                example: "axm",
+                notes: "IDE: case-sensitive command prefix in terminalAllowlist. CLI: Tool-call syntax Shell()/Read()/Write() with glob patterns. Deny always beats allow.\n",
+            },
+            prerequisites: [
+                {
+                    key: "Settings > Cursor Settings > Agents > Auto-Run",
+                    value: "Run in Sandbox | Run Everything",
+                    scope: "user",
+                    note: "IDE Auto-Run must be enabled before terminalAllowlist takes effect.",
+                },
+            ],
+            cliFlags: [
+                {
+                    flag: "--force",
+                    note: "Bypasses cursor-agent prompts (community-documented; verify against --help).",
+                },
+                {
+                    flag: "--yolo",
+                    note: "Bypasses cursor-agent prompts (community-documented; verify against --help).",
+                },
+            ],
+            grants: {
+                shell: {
+                    target: "~/.cursor/permissions.json",
+                    patch: {
+                        terminalAllowlist: ["${tool}"],
+                    },
+                },
+                cliShell: {
+                    target: ".cursor/cli.json",
+                    patch: {
+                        permissions: {
+                            allow: ["Shell(${tool})", "Shell(${tool}:*)"],
+                        },
+                    },
+                },
+                filesystem: {
+                    target: ".cursor/sandbox.json",
+                    patch: {
+                        type: "workspace_readwrite",
+                        additionalReadwritePaths: [],
+                    },
+                },
+            },
+        },
     },
     {
         id: "gemini-cli",
@@ -155,12 +520,49 @@ export const AGENTS = [
             scopes: ["user", "project"],
             directory: ".gemini/skills",
         },
+        commands: {
+            support: "bridged",
+            notes: "Custom slash commands are TOML files under .gemini/commands (project) or ~/.gemini/commands (user); AXM bridges its command extension format to TOML.\n",
+            sources: [
+                "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/custom-commands.md",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".gemini/commands",
+        },
         mcp: {
             support: "standard",
             sources: ["https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md"],
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio"],
+            config: {
+                serversKey: "mcpServers",
+                nativeEnabled: false,
+                targets: [
+                    {
+                        scope: "project",
+                        path: ".gemini/settings.json",
+                        format: "json",
+                    },
+                    {
+                        scope: "user",
+                        path: "~/.gemini/settings.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    command: "split",
+                    envKey: "env",
+                },
+            },
+        },
+        subagents: {
+            support: "bridged",
+            notes: "Subagents are Markdown files with YAML frontmatter under .gemini/agents (project) or ~/.gemini/agents (user); shipped in Gemini CLI v0.38.1.\n",
+            sources: ["https://github.com/google-gemini/gemini-cli/blob/main/docs/core/subagents.md"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
         },
         instructions: {
             support: "bridged",
@@ -170,6 +572,71 @@ export const AGENTS = [
             files: ["GEMINI.md"],
             nestedDiscovery: true,
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/settings.md",
+                "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md",
+                "https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/shell.md",
+                "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/trusted-folders.md",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            mechanism: ["config-file", "cli-flag"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/.gemini/settings.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".gemini/settings.json",
+                    format: "json",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "prefix",
+                example: "run_shell_command(axm)",
+                notes: "tools.core is prefix-matched and currently documented in docs/tools/shell.md. The newer Policy Engine is replacing --allowed-tools; tools.core is still functional but transitional.\n",
+            },
+            prerequisites: [
+                {
+                    key: "security.folderTrust.enabled",
+                    value: "true",
+                    scope: "user",
+                    note: "Untrusted folders disable all auto-acceptance regardless of other settings.",
+                },
+            ],
+            cliFlags: [
+                {
+                    flag: "--approval-mode=yolo",
+                    note: "Broad bypass; not tool-scoped. Blocked when security.disableYoloMode=true.",
+                },
+                {
+                    flag: "--yolo",
+                    note: "Alias for --approval-mode=yolo.",
+                },
+            ],
+            grants: {
+                shell: {
+                    target: "~/.gemini/settings.json",
+                    patch: {
+                        security: {
+                            folderTrust: {
+                                enabled: true,
+                            },
+                            enablePermanentToolApproval: true,
+                        },
+                        tools: {
+                            core: ["run_shell_command(${tool})"],
+                        },
+                    },
+                },
+            },
+        },
     },
     {
         id: "github-copilot",
@@ -184,6 +651,25 @@ export const AGENTS = [
                 url: "https://docs.github.com/en/copilot",
             },
         ],
+        skills: {
+            support: "standard",
+            notes: "VS Code agent mode, the Copilot CLI, and the cloud agent read SKILL.md skills from .github/skills (project) and ~/.copilot/skills (user); .claude/skills is also recognized.\n",
+            sources: [
+                "https://code.visualstudio.com/docs/copilot/customization/agent-skills",
+                "https://docs.github.com/en/copilot/concepts/agents/about-agent-skills",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".github/skills",
+        },
+        commands: {
+            support: "bridged",
+            notes: "VS Code Copilot prompt files (.prompt.md) act as slash commands under .github/prompts; the Copilot CLI does not yet support custom commands.\n",
+            sources: ["https://code.visualstudio.com/docs/copilot/customization/prompt-files"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".github/prompts",
+        },
         mcp: {
             support: "standard",
             sources: [
@@ -192,6 +678,39 @@ export const AGENTS = [
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio", "http", "sse"],
+            config: {
+                serversKey: "servers",
+                nativeEnabled: false,
+                targets: [
+                    {
+                        scope: "project",
+                        path: ".vscode/mcp.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    typeField: {
+                        name: "type",
+                        value: "stdio",
+                    },
+                    command: "split",
+                    envKey: "env",
+                },
+                remote: {
+                    typeField: {
+                        name: "type",
+                        value: {
+                            "streamable-http": "http",
+                            sse: "sse",
+                        },
+                    },
+                    urlKey: {
+                        "streamable-http": "url",
+                        sse: "url",
+                    },
+                    headersKey: "headers",
+                },
+            },
         },
         subagents: {
             support: "bridged",
@@ -207,6 +726,176 @@ export const AGENTS = [
             files: ["AGENTS.md", ".github/copilot-instructions.md"],
             nestedDiscovery: false,
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://code.visualstudio.com/docs/copilot/reference/copilot-settings",
+                "https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode",
+                "https://code.visualstudio.com/docs/copilot/agents/agent-tools",
+                "https://docs.github.com/en/copilot/concepts/agents/coding-agent",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            mechanism: ["config-file"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/Library/Application Support/Code/User/settings.json",
+                    format: "vscode-settings",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".vscode/settings.json",
+                    format: "vscode-settings",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "regex",
+                example: '"/^axm(\\\\s|$)/": true',
+                notes: "chat.tools.terminal.autoApprove keys are literal command names or /regex/ patterns mapping to bool. Default deny rules for rm, chmod, etc. remain active unless chat.tools.terminal.ignoreDefaultAutoApproveRules is set.\n",
+            },
+            cliFlags: [],
+            grants: {
+                shell: {
+                    target: ".vscode/settings.json",
+                    patch: {
+                        "chat.tools.terminal.autoApprove": {
+                            "${tool}": true,
+                            "/^${tool}(\\s|$)/": true,
+                        },
+                    },
+                },
+                filesystem: {
+                    target: ".vscode/settings.json",
+                    patch: {
+                        "chat.tools.edits.autoApprove": {
+                            "**/*": true,
+                        },
+                    },
+                },
+            },
+        },
+    },
+    {
+        id: "opencode",
+        name: "OpenCode",
+        vendor: "SST",
+        homepage: "https://opencode.ai",
+        interfaces: ["cli"],
+        docs: [
+            {
+                label: "OpenCode documentation",
+                url: "https://opencode.ai/docs",
+            },
+        ],
+        mcp: {
+            support: "standard",
+            sources: ["https://opencode.ai/docs/mcp-servers/", "https://opencode.ai/docs/config/"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            transports: ["stdio", "http"],
+            config: {
+                serversKey: "mcp",
+                nativeEnabled: true,
+                targets: [
+                    {
+                        scope: "project",
+                        path: "opencode.jsonc",
+                        format: "jsonc",
+                    },
+                    {
+                        scope: "user",
+                        path: "~/.config/opencode/opencode.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    typeField: {
+                        name: "type",
+                        value: "local",
+                    },
+                    command: "array",
+                    envKey: "environment",
+                },
+                remote: {
+                    typeField: {
+                        name: "type",
+                        value: {
+                            "streamable-http": "remote",
+                            sse: "remote",
+                        },
+                    },
+                    urlKey: {
+                        "streamable-http": "url",
+                        sse: "url",
+                    },
+                    headersKey: "headers",
+                },
+            },
+        },
+    },
+    {
+        id: "pi",
+        name: "Pi",
+        vendor: "Mario Zechner",
+        homepage: "https://github.com/badlogic/pi-mono",
+        interfaces: ["cli"],
+        docs: [
+            {
+                label: "Pi coding agent documentation",
+                url: "https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md",
+            },
+        ],
+        skills: {
+            support: "standard",
+            notes: "Skills follow the Agent Skills SKILL.md standard and are invoked via /skill:name. Pi discovers them from .pi/skills and .agents/skills (project, searched up through parent directories) and ~/.pi/agent/skills and ~/.agents/skills (user).\n",
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".pi/skills",
+        },
+        commands: {
+            support: "bridged",
+            notes: "Custom slash commands are Markdown prompt templates with {{variable}} interpolation, expanded via /templatename. Stored in .pi/prompts (project) or ~/.pi/agent/prompts (user). Recorded as bridged because prompt templates have no industry spec standard.\n",
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".pi/prompts",
+        },
+        mcp: {
+            support: "unsupported",
+            notes: 'Pi ships a deliberate "no MCP" core with only four built-in tools (read, write, edit, bash). MCP can only be added by installing or building a TypeScript extension; there is no native MCP server configuration.\n',
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: [],
+            transports: [],
+        },
+        subagents: {
+            support: "unsupported",
+            notes: "Pi has no built-in subagent system by design. Multi-agent workflows are expected to be composed externally (e.g. spawning pi instances under tmux) or via a TypeScript extension.\n",
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: [],
+        },
+        instructions: {
+            support: "standard",
+            notes: "AGENTS.md and CLAUDE.md context files load at startup from the global directory (~/.pi/agent), parent directories, and the current directory; all matching files are concatenated.\n",
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            files: ["AGENTS.md", "CLAUDE.md"],
+            nestedDiscovery: true,
+        },
+        permissions: {
+            support: "unsupported",
+            notes: "Pi has no per-call approval prompts and no permission config file. Tools run without confirmation; the philosophy is to run pi in a container or supply a confirmation flow via extension. Tool availability is selected at invocation with --tools and --no-builtin-tools, but this is tool enablement rather than a permission-grant surface.\n",
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: [],
+            mechanism: [],
+        },
     },
     {
         id: "windsurf",
@@ -221,12 +910,50 @@ export const AGENTS = [
                 url: "https://docs.windsurf.com",
             },
         ],
+        skills: {
+            support: "standard",
+            notes: "Cascade reads SKILL.md skills from .windsurf/skills (project) and ~/.codeium/windsurf/skills (user) with progressive disclosure.\n",
+            sources: ["https://docs.windsurf.com/windsurf/cascade/skills"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".windsurf/skills",
+        },
+        commands: {
+            support: "bridged",
+            notes: "Windsurf Workflows are slash-command-invoked Markdown prompts under .windsurf/workflows (project) and ~/.codeium/windsurf/global_workflows (user).\n",
+            sources: ["https://docs.windsurf.com/windsurf/cascade/workflows"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".windsurf/workflows",
+        },
         mcp: {
             support: "standard",
             sources: ["https://docs.windsurf.com/windsurf/cascade/mcp"],
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio"],
+            config: {
+                serversKey: "mcpServers",
+                nativeEnabled: false,
+                targets: [
+                    {
+                        scope: "user",
+                        path: "~/.codeium/windsurf/mcp_config.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    command: "split",
+                    envKey: "env",
+                },
+            },
+        },
+        subagents: {
+            support: "unsupported",
+            notes: "Cascade exposes only built-in and internal subagents plus multi-agent sessions; no user-authorable custom subagent extension type is documented.\n",
+            sources: ["https://docs.windsurf.com/windsurf/cascade/agents-md"],
+            lastVerified: "2026-05-18",
+            scopes: [],
         },
         instructions: {
             support: "standard",
@@ -243,6 +970,45 @@ export const AGENTS = [
             scopes: ["user", "project"],
             directory: ".windsurf/rules",
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://docs.windsurf.com/windsurf/terminal",
+                "https://docs.windsurf.com/windsurf/cascade",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user"],
+            mechanism: ["config-file", "ui-only"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "VS Code settings (Settings UI)",
+                    format: "vscode-settings",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "prefix",
+                example: "axm",
+                notes: "windsurf.cascadeCommandsAllowList is prefix-matched. Workspace-scoped override for these keys is not documented; configure at user scope. Teams/Enterprise can merge in lists via the Admin Portal.\n",
+            },
+            prerequisites: [
+                {
+                    key: "Cascade auto-execution level",
+                    value: "allowlist_only | turbo",
+                    scope: "user",
+                    note: "Disabled and Auto modes ignore allowlist entries; set via the Windsurf Settings panel.",
+                },
+            ],
+            grants: {
+                shell: {
+                    target: "VS Code settings",
+                    patch: {
+                        "windsurf.cascadeCommandsAllowList": ["${tool}"],
+                    },
+                },
+            },
+        },
     },
 ];
 /** @experimental This API is unstable and may change without notice. */
@@ -268,9 +1034,10 @@ export const AGENTS_BY_ID = {
             directory: ".claude/skills",
         },
         commands: {
-            support: "standard",
+            support: "bridged",
+            notes: "Custom slash commands are Markdown prompt files under .claude/commands. Recorded as bridged because commands have no industry spec standard.\n",
             sources: ["https://docs.claude.com/en/docs/claude-code/slash-commands"],
-            lastVerified: "2026-05-16",
+            lastVerified: "2026-05-18",
             scopes: ["user", "project"],
             directory: ".claude/commands",
         },
@@ -280,6 +1047,39 @@ export const AGENTS_BY_ID = {
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio", "http", "sse"],
+            config: {
+                serversKey: "mcpServers",
+                nativeEnabled: false,
+                targets: [
+                    {
+                        scope: "project",
+                        path: ".mcp.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    typeField: {
+                        name: "type",
+                        value: "stdio",
+                    },
+                    command: "split",
+                    envKey: "env",
+                },
+                remote: {
+                    typeField: {
+                        name: "type",
+                        value: {
+                            "streamable-http": "http",
+                            sse: "sse",
+                        },
+                    },
+                    urlKey: {
+                        "streamable-http": "url",
+                        sse: "url",
+                    },
+                    headersKey: "headers",
+                },
+            },
         },
         subagents: {
             support: "bridged",
@@ -295,6 +1095,63 @@ export const AGENTS_BY_ID = {
             files: ["CLAUDE.md"],
             nestedDiscovery: true,
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://docs.claude.com/en/docs/claude-code/iam",
+                "https://docs.claude.com/en/docs/claude-code/settings",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            mechanism: ["config-file"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/.claude/settings.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".claude/settings.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".claude/settings.local.json",
+                    format: "json",
+                    gitignored: true,
+                },
+            ],
+            grammar: {
+                style: "tool-call",
+                example: "Bash(axm:*)",
+                notes: "Tool(specifier) with * wildcards. Evaluated deny > ask > allow (first match wins). Settings merge across scopes rather than override.\n",
+            },
+            grants: {
+                shell: {
+                    target: "~/.claude/settings.json",
+                    patch: {
+                        permissions: {
+                            allow: ["Bash(${tool}:*)"],
+                        },
+                    },
+                },
+                filesystem: {
+                    target: "~/.claude/settings.json",
+                    patch: {
+                        permissions: {
+                            allow: [
+                                "Read(${workspaceRoot}/**)",
+                                "Write(${workspaceRoot}/**)",
+                                "Edit(${workspaceRoot}/**)",
+                            ],
+                        },
+                    },
+                },
+            },
+        },
     },
     codex: {
         id: "codex",
@@ -309,12 +1166,73 @@ export const AGENTS_BY_ID = {
                 url: "https://developers.openai.com/codex",
             },
         ],
+        skills: {
+            support: "standard",
+            notes: "Reads SKILL.md skills from repository (.agents/skills) and user (~/.agents/skills) locations with progressive disclosure, using the cross-tool Agent Skills convention rather than a .codex/ path.\n",
+            sources: ["https://developers.openai.com/codex/skills"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".agents/skills",
+        },
+        commands: {
+            support: "bridged",
+            notes: "Custom prompts are user-scope Markdown slash commands in ~/.codex/prompts. Deprecated by OpenAI in favor of skills for reusable instructions, and there is no project-scoped command directory.\n",
+            sources: [
+                "https://developers.openai.com/codex/custom-prompts",
+                "https://developers.openai.com/codex/cli/slash-commands",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user"],
+            directory: "~/.codex/prompts",
+        },
         mcp: {
             support: "standard",
             sources: ["https://github.com/openai/codex/blob/main/docs/config.md#mcp-servers"],
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio", "http"],
+            config: {
+                serversKey: "mcp_servers",
+                nativeEnabled: true,
+                targets: [
+                    {
+                        scope: "project",
+                        path: ".codex/config.toml",
+                        format: "toml",
+                    },
+                    {
+                        scope: "user",
+                        path: "~/.codex/config.toml",
+                        format: "toml",
+                    },
+                ],
+                stdio: {
+                    command: "split",
+                    envKey: "env",
+                },
+                remote: {
+                    typeField: {
+                        name: "type",
+                        value: {
+                            "streamable-http": "streamable-http",
+                            sse: "sse",
+                        },
+                    },
+                    urlKey: {
+                        "streamable-http": "url",
+                        sse: "url",
+                    },
+                    headersKey: "http_headers",
+                },
+                transform: "codex-toml",
+            },
+        },
+        subagents: {
+            support: "bridged",
+            notes: "Custom agents are standalone TOML files under .codex/agents (project) or ~/.codex/agents (user); a custom agent overrides a built-in of the same name.\n",
+            sources: ["https://developers.openai.com/codex/subagents"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
         },
         instructions: {
             support: "standard",
@@ -324,6 +1242,79 @@ export const AGENTS_BY_ID = {
             files: ["AGENTS.md"],
             nestedDiscovery: true,
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://developers.openai.com/codex/config-reference",
+                "https://developers.openai.com/codex/config-advanced",
+                "https://developers.openai.com/codex/security",
+                "https://developers.openai.com/codex/rules",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            mechanism: ["config-file", "cli-flag"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/.codex/config.toml",
+                    format: "toml",
+                    gitignored: false,
+                },
+                {
+                    scope: "user",
+                    path: "~/.codex/rules/${tool}.rules",
+                    format: "starlark",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "starlark-rule",
+                example: 'prefix_rule(pattern=["axm"], decision="allow")',
+                notes: "Per-command allowlisting is Starlark prefix_rule() in ~/.codex/rules/*.rules. Sandbox and approval mode live separately in config.toml. Most restrictive match wins (forbidden > prompt > allow).\n",
+            },
+            prerequisites: [
+                {
+                    key: "sandbox_mode",
+                    value: "workspace-write",
+                    scope: "user",
+                    note: "Required to grant project write access.",
+                },
+                {
+                    key: "approval_policy",
+                    value: "never",
+                    scope: "user",
+                    note: "Suppresses approval prompts.",
+                },
+            ],
+            cliFlags: [
+                {
+                    flag: "--full-auto",
+                    note: "Equivalent one-shot bypass of prompts and sandbox restrictions.",
+                },
+                {
+                    flag: "--sandbox workspace-write",
+                },
+                {
+                    flag: "--ask-for-approval never",
+                },
+            ],
+            grants: {
+                shell: {
+                    target: "~/.codex/rules/${tool}.rules",
+                    template: 'prefix_rule(\n    pattern = ["${tool}"],\n    decision = "allow",\n    justification = "${tool} CLI trusted in this workspace.",\n)\n',
+                },
+                filesystem: {
+                    target: "~/.codex/config.toml",
+                    patch: {
+                        sandbox_mode: "workspace-write",
+                        sandbox_workspace_write: {
+                            writable_roots: ["${workspaceRoot}"],
+                            network_access: true,
+                        },
+                    },
+                },
+            },
+        },
     },
     cursor: {
         id: "cursor",
@@ -338,12 +1329,60 @@ export const AGENTS_BY_ID = {
                 url: "https://docs.cursor.com",
             },
         ],
+        skills: {
+            support: "standard",
+            notes: "Cursor 2.4 added Agent Skills (SKILL.md) across the editor and the cursor-agent CLI; it also loads .claude/skills and .codex/skills for cross-tool compatibility.\n",
+            sources: ["https://cursor.com/docs/context/skills", "https://cursor.com/changelog/2-4"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".cursor/skills",
+        },
+        commands: {
+            support: "bridged",
+            notes: "Custom commands are Markdown prompt files under .cursor/commands (project) or ~/.cursor/commands (user); documented as a beta feature.\n",
+            sources: [
+                "https://docs.cursor.com/en/agent/chat/commands",
+                "https://cursor.com/changelog/1-6",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".cursor/commands",
+        },
         mcp: {
             support: "standard",
             sources: ["https://docs.cursor.com/advanced/model-context-protocol"],
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio", "http", "sse"],
+            config: {
+                serversKey: "mcpServers",
+                nativeEnabled: false,
+                targets: [
+                    {
+                        scope: "project",
+                        path: ".cursor/mcp.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    command: "split",
+                    envKey: "env",
+                },
+                remote: {
+                    urlKey: {
+                        "streamable-http": "url",
+                        sse: "url",
+                    },
+                    headersKey: "headers",
+                },
+            },
+        },
+        subagents: {
+            support: "bridged",
+            notes: "Custom subagents are Markdown files with YAML frontmatter under .cursor/agents (project) or ~/.cursor/agents (user); added in Cursor 2.4.\n",
+            sources: ["https://cursor.com/docs/subagents", "https://cursor.com/changelog/2-4"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
         },
         instructions: {
             support: "standard",
@@ -360,6 +1399,96 @@ export const AGENTS_BY_ID = {
             scopes: ["project"],
             directory: ".cursor/rules",
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://cursor.com/docs/reference/permissions",
+                "https://cursor.com/docs/reference/sandbox",
+                "https://cursor.com/docs/agent/tools/terminal",
+                "https://cursor.com/docs/cli/reference/permissions",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            mechanism: ["config-file", "ui-only", "cli-flag"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/.cursor/permissions.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "user",
+                    path: "~/.cursor/sandbox.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".cursor/sandbox.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "user",
+                    path: "~/.cursor/cli-config.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".cursor/cli.json",
+                    format: "json",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "prefix",
+                example: "axm",
+                notes: "IDE: case-sensitive command prefix in terminalAllowlist. CLI: Tool-call syntax Shell()/Read()/Write() with glob patterns. Deny always beats allow.\n",
+            },
+            prerequisites: [
+                {
+                    key: "Settings > Cursor Settings > Agents > Auto-Run",
+                    value: "Run in Sandbox | Run Everything",
+                    scope: "user",
+                    note: "IDE Auto-Run must be enabled before terminalAllowlist takes effect.",
+                },
+            ],
+            cliFlags: [
+                {
+                    flag: "--force",
+                    note: "Bypasses cursor-agent prompts (community-documented; verify against --help).",
+                },
+                {
+                    flag: "--yolo",
+                    note: "Bypasses cursor-agent prompts (community-documented; verify against --help).",
+                },
+            ],
+            grants: {
+                shell: {
+                    target: "~/.cursor/permissions.json",
+                    patch: {
+                        terminalAllowlist: ["${tool}"],
+                    },
+                },
+                cliShell: {
+                    target: ".cursor/cli.json",
+                    patch: {
+                        permissions: {
+                            allow: ["Shell(${tool})", "Shell(${tool}:*)"],
+                        },
+                    },
+                },
+                filesystem: {
+                    target: ".cursor/sandbox.json",
+                    patch: {
+                        type: "workspace_readwrite",
+                        additionalReadwritePaths: [],
+                    },
+                },
+            },
+        },
     },
     "gemini-cli": {
         id: "gemini-cli",
@@ -381,12 +1510,49 @@ export const AGENTS_BY_ID = {
             scopes: ["user", "project"],
             directory: ".gemini/skills",
         },
+        commands: {
+            support: "bridged",
+            notes: "Custom slash commands are TOML files under .gemini/commands (project) or ~/.gemini/commands (user); AXM bridges its command extension format to TOML.\n",
+            sources: [
+                "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/custom-commands.md",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".gemini/commands",
+        },
         mcp: {
             support: "standard",
             sources: ["https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md"],
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio"],
+            config: {
+                serversKey: "mcpServers",
+                nativeEnabled: false,
+                targets: [
+                    {
+                        scope: "project",
+                        path: ".gemini/settings.json",
+                        format: "json",
+                    },
+                    {
+                        scope: "user",
+                        path: "~/.gemini/settings.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    command: "split",
+                    envKey: "env",
+                },
+            },
+        },
+        subagents: {
+            support: "bridged",
+            notes: "Subagents are Markdown files with YAML frontmatter under .gemini/agents (project) or ~/.gemini/agents (user); shipped in Gemini CLI v0.38.1.\n",
+            sources: ["https://github.com/google-gemini/gemini-cli/blob/main/docs/core/subagents.md"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
         },
         instructions: {
             support: "bridged",
@@ -396,6 +1562,71 @@ export const AGENTS_BY_ID = {
             files: ["GEMINI.md"],
             nestedDiscovery: true,
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/settings.md",
+                "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md",
+                "https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/shell.md",
+                "https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/trusted-folders.md",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            mechanism: ["config-file", "cli-flag"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/.gemini/settings.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".gemini/settings.json",
+                    format: "json",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "prefix",
+                example: "run_shell_command(axm)",
+                notes: "tools.core is prefix-matched and currently documented in docs/tools/shell.md. The newer Policy Engine is replacing --allowed-tools; tools.core is still functional but transitional.\n",
+            },
+            prerequisites: [
+                {
+                    key: "security.folderTrust.enabled",
+                    value: "true",
+                    scope: "user",
+                    note: "Untrusted folders disable all auto-acceptance regardless of other settings.",
+                },
+            ],
+            cliFlags: [
+                {
+                    flag: "--approval-mode=yolo",
+                    note: "Broad bypass; not tool-scoped. Blocked when security.disableYoloMode=true.",
+                },
+                {
+                    flag: "--yolo",
+                    note: "Alias for --approval-mode=yolo.",
+                },
+            ],
+            grants: {
+                shell: {
+                    target: "~/.gemini/settings.json",
+                    patch: {
+                        security: {
+                            folderTrust: {
+                                enabled: true,
+                            },
+                            enablePermanentToolApproval: true,
+                        },
+                        tools: {
+                            core: ["run_shell_command(${tool})"],
+                        },
+                    },
+                },
+            },
+        },
     },
     "github-copilot": {
         id: "github-copilot",
@@ -410,6 +1641,25 @@ export const AGENTS_BY_ID = {
                 url: "https://docs.github.com/en/copilot",
             },
         ],
+        skills: {
+            support: "standard",
+            notes: "VS Code agent mode, the Copilot CLI, and the cloud agent read SKILL.md skills from .github/skills (project) and ~/.copilot/skills (user); .claude/skills is also recognized.\n",
+            sources: [
+                "https://code.visualstudio.com/docs/copilot/customization/agent-skills",
+                "https://docs.github.com/en/copilot/concepts/agents/about-agent-skills",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".github/skills",
+        },
+        commands: {
+            support: "bridged",
+            notes: "VS Code Copilot prompt files (.prompt.md) act as slash commands under .github/prompts; the Copilot CLI does not yet support custom commands.\n",
+            sources: ["https://code.visualstudio.com/docs/copilot/customization/prompt-files"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".github/prompts",
+        },
         mcp: {
             support: "standard",
             sources: [
@@ -418,6 +1668,39 @@ export const AGENTS_BY_ID = {
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio", "http", "sse"],
+            config: {
+                serversKey: "servers",
+                nativeEnabled: false,
+                targets: [
+                    {
+                        scope: "project",
+                        path: ".vscode/mcp.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    typeField: {
+                        name: "type",
+                        value: "stdio",
+                    },
+                    command: "split",
+                    envKey: "env",
+                },
+                remote: {
+                    typeField: {
+                        name: "type",
+                        value: {
+                            "streamable-http": "http",
+                            sse: "sse",
+                        },
+                    },
+                    urlKey: {
+                        "streamable-http": "url",
+                        sse: "url",
+                    },
+                    headersKey: "headers",
+                },
+            },
         },
         subagents: {
             support: "bridged",
@@ -433,6 +1716,176 @@ export const AGENTS_BY_ID = {
             files: ["AGENTS.md", ".github/copilot-instructions.md"],
             nestedDiscovery: false,
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://code.visualstudio.com/docs/copilot/reference/copilot-settings",
+                "https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode",
+                "https://code.visualstudio.com/docs/copilot/agents/agent-tools",
+                "https://docs.github.com/en/copilot/concepts/agents/coding-agent",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            mechanism: ["config-file"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/Library/Application Support/Code/User/settings.json",
+                    format: "vscode-settings",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".vscode/settings.json",
+                    format: "vscode-settings",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "regex",
+                example: '"/^axm(\\\\s|$)/": true',
+                notes: "chat.tools.terminal.autoApprove keys are literal command names or /regex/ patterns mapping to bool. Default deny rules for rm, chmod, etc. remain active unless chat.tools.terminal.ignoreDefaultAutoApproveRules is set.\n",
+            },
+            cliFlags: [],
+            grants: {
+                shell: {
+                    target: ".vscode/settings.json",
+                    patch: {
+                        "chat.tools.terminal.autoApprove": {
+                            "${tool}": true,
+                            "/^${tool}(\\s|$)/": true,
+                        },
+                    },
+                },
+                filesystem: {
+                    target: ".vscode/settings.json",
+                    patch: {
+                        "chat.tools.edits.autoApprove": {
+                            "**/*": true,
+                        },
+                    },
+                },
+            },
+        },
+    },
+    opencode: {
+        id: "opencode",
+        name: "OpenCode",
+        vendor: "SST",
+        homepage: "https://opencode.ai",
+        interfaces: ["cli"],
+        docs: [
+            {
+                label: "OpenCode documentation",
+                url: "https://opencode.ai/docs",
+            },
+        ],
+        mcp: {
+            support: "standard",
+            sources: ["https://opencode.ai/docs/mcp-servers/", "https://opencode.ai/docs/config/"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            transports: ["stdio", "http"],
+            config: {
+                serversKey: "mcp",
+                nativeEnabled: true,
+                targets: [
+                    {
+                        scope: "project",
+                        path: "opencode.jsonc",
+                        format: "jsonc",
+                    },
+                    {
+                        scope: "user",
+                        path: "~/.config/opencode/opencode.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    typeField: {
+                        name: "type",
+                        value: "local",
+                    },
+                    command: "array",
+                    envKey: "environment",
+                },
+                remote: {
+                    typeField: {
+                        name: "type",
+                        value: {
+                            "streamable-http": "remote",
+                            sse: "remote",
+                        },
+                    },
+                    urlKey: {
+                        "streamable-http": "url",
+                        sse: "url",
+                    },
+                    headersKey: "headers",
+                },
+            },
+        },
+    },
+    pi: {
+        id: "pi",
+        name: "Pi",
+        vendor: "Mario Zechner",
+        homepage: "https://github.com/badlogic/pi-mono",
+        interfaces: ["cli"],
+        docs: [
+            {
+                label: "Pi coding agent documentation",
+                url: "https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md",
+            },
+        ],
+        skills: {
+            support: "standard",
+            notes: "Skills follow the Agent Skills SKILL.md standard and are invoked via /skill:name. Pi discovers them from .pi/skills and .agents/skills (project, searched up through parent directories) and ~/.pi/agent/skills and ~/.agents/skills (user).\n",
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".pi/skills",
+        },
+        commands: {
+            support: "bridged",
+            notes: "Custom slash commands are Markdown prompt templates with {{variable}} interpolation, expanded via /templatename. Stored in .pi/prompts (project) or ~/.pi/agent/prompts (user). Recorded as bridged because prompt templates have no industry spec standard.\n",
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".pi/prompts",
+        },
+        mcp: {
+            support: "unsupported",
+            notes: 'Pi ships a deliberate "no MCP" core with only four built-in tools (read, write, edit, bash). MCP can only be added by installing or building a TypeScript extension; there is no native MCP server configuration.\n',
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: [],
+            transports: [],
+        },
+        subagents: {
+            support: "unsupported",
+            notes: "Pi has no built-in subagent system by design. Multi-agent workflows are expected to be composed externally (e.g. spawning pi instances under tmux) or via a TypeScript extension.\n",
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: [],
+        },
+        instructions: {
+            support: "standard",
+            notes: "AGENTS.md and CLAUDE.md context files load at startup from the global directory (~/.pi/agent), parent directories, and the current directory; all matching files are concatenated.\n",
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            files: ["AGENTS.md", "CLAUDE.md"],
+            nestedDiscovery: true,
+        },
+        permissions: {
+            support: "unsupported",
+            notes: "Pi has no per-call approval prompts and no permission config file. Tools run without confirmation; the philosophy is to run pi in a container or supply a confirmation flow via extension. Tool availability is selected at invocation with --tools and --no-builtin-tools, but this is tool enablement rather than a permission-grant surface.\n",
+            sources: ["https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md"],
+            lastVerified: "2026-05-18",
+            scopes: [],
+            mechanism: [],
+        },
     },
     windsurf: {
         id: "windsurf",
@@ -447,12 +1900,50 @@ export const AGENTS_BY_ID = {
                 url: "https://docs.windsurf.com",
             },
         ],
+        skills: {
+            support: "standard",
+            notes: "Cascade reads SKILL.md skills from .windsurf/skills (project) and ~/.codeium/windsurf/skills (user) with progressive disclosure.\n",
+            sources: ["https://docs.windsurf.com/windsurf/cascade/skills"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".windsurf/skills",
+        },
+        commands: {
+            support: "bridged",
+            notes: "Windsurf Workflows are slash-command-invoked Markdown prompts under .windsurf/workflows (project) and ~/.codeium/windsurf/global_workflows (user).\n",
+            sources: ["https://docs.windsurf.com/windsurf/cascade/workflows"],
+            lastVerified: "2026-05-18",
+            scopes: ["user", "project"],
+            directory: ".windsurf/workflows",
+        },
         mcp: {
             support: "standard",
             sources: ["https://docs.windsurf.com/windsurf/cascade/mcp"],
             lastVerified: "2026-05-16",
             scopes: ["user", "project"],
             transports: ["stdio"],
+            config: {
+                serversKey: "mcpServers",
+                nativeEnabled: false,
+                targets: [
+                    {
+                        scope: "user",
+                        path: "~/.codeium/windsurf/mcp_config.json",
+                        format: "json",
+                    },
+                ],
+                stdio: {
+                    command: "split",
+                    envKey: "env",
+                },
+            },
+        },
+        subagents: {
+            support: "unsupported",
+            notes: "Cascade exposes only built-in and internal subagents plus multi-agent sessions; no user-authorable custom subagent extension type is documented.\n",
+            sources: ["https://docs.windsurf.com/windsurf/cascade/agents-md"],
+            lastVerified: "2026-05-18",
+            scopes: [],
         },
         instructions: {
             support: "standard",
@@ -469,6 +1960,45 @@ export const AGENTS_BY_ID = {
             scopes: ["user", "project"],
             directory: ".windsurf/rules",
         },
+        permissions: {
+            support: "standard",
+            sources: [
+                "https://docs.windsurf.com/windsurf/terminal",
+                "https://docs.windsurf.com/windsurf/cascade",
+            ],
+            lastVerified: "2026-05-18",
+            scopes: ["user"],
+            mechanism: ["config-file", "ui-only"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "VS Code settings (Settings UI)",
+                    format: "vscode-settings",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "prefix",
+                example: "axm",
+                notes: "windsurf.cascadeCommandsAllowList is prefix-matched. Workspace-scoped override for these keys is not documented; configure at user scope. Teams/Enterprise can merge in lists via the Admin Portal.\n",
+            },
+            prerequisites: [
+                {
+                    key: "Cascade auto-execution level",
+                    value: "allowlist_only | turbo",
+                    scope: "user",
+                    note: "Disabled and Auto modes ignore allowlist entries; set via the Windsurf Settings panel.",
+                },
+            ],
+            grants: {
+                shell: {
+                    target: "VS Code settings",
+                    patch: {
+                        "windsurf.cascadeCommandsAllowList": ["${tool}"],
+                    },
+                },
+            },
+        },
     },
 };
 //# sourceMappingURL=catalog.generated.js.map