feat: add WebMCP client module and update agent skills for AI integration

Author: 8bitAlex

site/docusaurus.config.ts

@@ -27,6 +27,8 @@ const config: Config = {
     locales: ['en'],
   },
 
+  clientModules: [require.resolve('./src/clientModules/webmcp.ts')],
+
   plugins: [
     [
       '@easyops-cn/docusaurus-search-local',

site/src/clientModules/webmcp.ts

@@ -0,0 +1,61 @@
+// WebMCP: expose raid docs tools to AI agents via the browser
+// https://webmachinelearning.github.io/webmcp/
+export function onRouteDidUpdate(): void {
+  if (typeof navigator === 'undefined' || !('modelContext' in navigator)) {
+    return;
+  }
+
+  (navigator as any).modelContext.provideContext({
+    tools: [
+      {
+        name: 'navigate_to_docs',
+        description: 'Navigate to a section of the raid documentation.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            section: {
+              type: 'string',
+              enum: ['overview', 'usage', 'features', 'examples', 'references', 'whats-new'],
+              description: 'The documentation section to navigate to.',
+            },
+          },
+          required: ['section'],
+        },
+        execute: async ({ section }: { section: string }) => {
+          const paths: Record<string, string> = {
+            'overview':    '/docs/overview',
+            'usage':       '/docs/category/usage',
+            'features':    '/docs/category/features',
+            'examples':    '/docs/category/examples',
+            'references':  '/docs/category/references',
+            'whats-new':   '/docs/whats-new',
+          };
+          window.location.href = paths[section] ?? '/docs/overview';
+        },
+      },
+      {
+        name: 'get_install_command',
+        description: 'Returns the command to install raid on the current platform.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            platform: {
+              type: 'string',
+              enum: ['macos', 'linux', 'windows'],
+              description: 'Target platform.',
+            },
+          },
+          required: ['platform'],
+        },
+        execute: async ({ platform }: { platform: string }) => {
+          const commands: Record<string, string> = {
+            macos:   'brew install 8bitalex/tap/raid',
+            linux:   'curl -sSL https://github.com/8bitalex/raid/releases/latest/download/raid_linux_amd64.tar.gz | tar -xz && sudo mv raid /usr/local/bin/',
+            windows: 'scoop bucket add 8bitalex https://github.com/8bitalex/scoop-bucket && scoop install raid',
+          };
+          return commands[platform] ?? commands.macos;
+        },
+      },
+    ],
+  });
+}

site/static/.well-known/agent-skills/index.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://agentskills.io/schema/v0.2.0/index.schema.json",
+  "skills": [
+    {
+      "name": "raid-mcp-server",
+      "type": "mcp",
+      "description": "MCP stdio server exposing raid tools for managing multi-repo development environments. Install raid and run `raid context serve` to activate.",
+      "url": "https://raidcli.dev/.well-known/mcp/server-card.json"
+    }
+  ]
+}

site/static/.well-known/api-catalog

@@ -0,0 +1,13 @@
+{
+  "linkset": [
+    {
+      "anchor": "https://raidcli.dev/",
+      "service-doc": [
+        { "href": "https://raidcli.dev/docs", "type": "text/html" }
+      ],
+      "describedby": [
+        { "href": "https://raidcli.dev/docs/references/schema", "type": "text/html" }
+      ]
+    }
+  ]
+}

site/static/.well-known/mcp/server-card.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": "1.0",
+  "serverInfo": {
+    "name": "raid",
+    "version": "0.7.4-beta",
+    "description": "Distributed development environment orchestrator. Manages multi-repo workflows, environments, and tasks via an MCP stdio server."
+  },
+  "transport": [
+    {
+      "type": "stdio",
+      "command": "raid context serve"
+    }
+  ],
+  "capabilities": {
+    "tools": [
+      { "name": "raid_install",       "description": "Clone repositories and run install tasks for the active profile" },
+      { "name": "raid_env_switch",    "description": "Switch to a named environment and run its tasks" },
+      { "name": "raid_run_task",      "description": "Execute a named command from the active profile" },
+      { "name": "raid_list_profiles", "description": "List all available profiles" },
+      { "name": "raid_list_repos",    "description": "List repositories in the active profile" },
+      { "name": "raid_describe_repo", "description": "Get details about a specific repository by name or path" }
+    ]
+  },
+  "documentation": "https://raidcli.dev/docs/usage/context"
+}

site/static/robots.txt

@@ -0,0 +1,35 @@
+# All crawlers: allow full site
+User-agent: *
+Allow: /
+Disallow:
+
+# AI search agents: explicitly welcome
+User-agent: GPTBot
+Allow: /
+
+User-agent: OAI-SearchBot
+Allow: /
+
+User-agent: Claude-Web
+Allow: /
+
+User-agent: Google-Extended
+Allow: /
+
+User-agent: Applebot-Extended
+Allow: /
+
+User-agent: PerplexityBot
+Allow: /
+
+# AI training crawlers: disallowed
+User-agent: CCBot
+Disallow: /
+
+User-agent: anthropic-ai
+Disallow: /
+
+# Content usage preferences (https://contentsignals.org/)
+Content-Signal: ai-train=no, search=yes, ai-input=yes
+
+Sitemap: https://raidcli.dev/sitemap.xml