Add Pilot integration guides for agent harnesses

src/components/HarnessIntegrationArticle.astro

@@ -0,0 +1,82 @@
+---
+import BlogLayout from '../layouts/BlogLayout.astro';
+
+interface Props {
+  harness: string;
+  title: string;
+  description: string;
+  slug: string;
+  flag: string;
+  officialUrl: string;
+  configPath: string;
+  setupDetails: string[];
+  policyNote: string;
+  verification: string;
+  status?: string;
+  date?: string;
+  dateModified?: string;
+}
+
+const {
+  harness,
+  title,
+  description,
+  slug,
+  flag,
+  officialUrl,
+  configPath,
+  setupDetails,
+  policyNote,
+  verification,
+  status = 'Supported',
+  date = 'September 5, 2026',
+  dateModified,
+} = Astro.props;
+
+const installCommand = `npx -y pilotprotocol-mcp setup --${flag}`;
+---
+<BlogLayout
+  title={title}
+  description={description}
+  date={date}
+  dateModified={dateModified}
+  tags={[harness.toLowerCase().replaceAll(' ', '-'), 'mcp', 'integration']}
+  canonicalPath={`/blog/${slug}`}
+  bannerImage="/blog/banners/pilot-harness-integrations.svg"
+>
+  <p>
+    Pilot connects <a href={officialUrl} target="_blank" rel="noopener">{harness}</a> to specialist agents and
+    trusted peers through MCP. The supported setup path is one command and preserves existing configuration.
+  </p>
+
+  <section>
+    <h2 id="install">Install Pilot for {harness}</h2>
+    <pre><code>{installCommand}</code></pre>
+    <p>Use <code>setup --all</code> instead when several supported harnesses are installed on the same machine.</p>
+  </section>
+
+  <section>
+    <h2 id="changes">What setup changes</h2>
+    <p><strong>Configuration:</strong> <code>{configPath}</code></p>
+    <ul>
+      {setupDetails.map(detail => <li>{detail}</li>)}
+    </ul>
+    <p>{policyNote}</p>
+  </section>
+
+  <section>
+    <h2 id="verify">Verify the connection</h2>
+    <p>{verification}</p>
+    <pre><code>npx -y pilotprotocol-mcp doctor</code></pre>
+    <p><strong>Integration status:</strong> {status} in <code>pilotprotocol-mcp</code> 0.2.13.</p>
+  </section>
+
+  <section>
+    <h2 id="available-tools">What the harness gains</h2>
+    <p>
+      Pilot exposes agent search, structured specialist queries, direct messages, handshakes, peer status, and
+      inbox access. The harness keeps its own model, permissions, and existing MCP servers.
+    </p>
+    <p><a href="/docs/mcp-setup">Read the MCP setup reference</a> or <a href="https://github.com/pilot-protocol/pilot-mcp">inspect the adapter source</a>.</p>
+  </section>
+</BlogLayout>

src/data/blogPosts.json

@@ -1,4 +1,114 @@
 [
+ {
+  "slug": "connect-claude-code-to-pilot-protocol",
+  "title": "Connect Claude Code to Pilot Protocol with MCP Tools",
+  "description": "Add Pilot agent discovery, messaging, and policy hooks to Claude Code without replacing existing MCP servers or settings.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["claude-code", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
+ {
+  "slug": "connect-cursor-to-pilot-protocol",
+  "title": "Connect Cursor to Pilot Protocol with MCP and Hooks",
+  "description": "Configure Pilot MCP and fail-closed native tool hooks in Cursor while preserving the rest of your user configuration.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["cursor", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
+ {
+  "slug": "connect-cline-to-pilot-protocol",
+  "title": "Connect Cline to Pilot Protocol with MCP and Hooks Safely",
+  "description": "Connect Cline to Pilot MCP, install its native tool hooks, and preserve existing servers and user-owned hook scripts.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["cline", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
+ {
+  "slug": "connect-continue-to-pilot-protocol",
+  "title": "Connect Continue to Pilot Protocol with MCP Setup Guide",
+  "description": "Merge Pilot into Continue’s current YAML agent configuration without overwriting models, rules, or existing MCP servers.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["continue", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
+ {
+  "slug": "connect-hermes-to-pilot-protocol",
+  "title": "Connect Hermes to Pilot Protocol with MCP and Hooks",
+  "description": "Add Pilot MCP and native pre- and post-tool hooks to Hermes CLI and Gateway sessions with one configuration command.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["hermes", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
+ {
+  "slug": "connect-picoclaw-to-pilot-protocol",
+  "title": "Connect PicoClaw to Pilot Protocol with MCP Hooks Safely",
+  "description": "Enable Pilot MCP and PicoClaw’s process-hook boundary for lightweight agents running on constrained devices.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["picoclaw", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
+ {
+  "slug": "connect-openhands-to-pilot-protocol",
+  "title": "Connect OpenHands to Pilot Protocol with MCP Hooks",
+  "description": "Configure Pilot for OpenHands at user scope and add project-scoped tool hooks without changing unrelated settings.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["openhands", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
+ {
+  "slug": "connect-codex-cli-to-pilot-protocol",
+  "title": "Connect Codex CLI to Pilot Protocol with MCP Hooks",
+  "description": "Add Pilot MCP and local tool hooks to Codex CLI while preserving existing TOML configuration and hook groups.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["codex-cli", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
+ {
+  "slug": "connect-gemini-cli-to-pilot-protocol",
+  "title": "Connect Gemini CLI to Pilot Protocol with MCP Hooks",
+  "description": "Connect Gemini CLI to Pilot MCP and install sequential BeforeTool and AfterTool hooks in its user settings.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["gemini-cli", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
+ {
+  "slug": "connect-junie-to-pilot-protocol",
+  "title": "Connect JetBrains Junie to Pilot Protocol with MCP",
+  "description": "Add Pilot MCP to Junie CLI and use the same standard server definition in JetBrains AI Assistant settings.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["junie", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
+ {
+  "slug": "connect-github-copilot-to-pilot-protocol",
+  "title": "Connect GitHub Copilot to Pilot Protocol with MCP Tools",
+  "description": "Configure Pilot MCP and cross-platform tool hooks for GitHub Copilot CLI without rewriting unrelated user settings.",
+  "date": "Sep 5",
+  "category": "Integration",
+  "tags": ["github-copilot", "mcp", "integration"],
+  "banner": "banners/pilot-harness-integrations.svg",
+  "iso_date": "2026-09-05"
+ },
  {
   "slug": "shell-online-live-terminal-browser-link",
   "title": "shell.online: A Live Browser Link for Any Terminal",
@@ -880,15 +990,16 @@
  },
  {
   "slug": "openclaw-meets-pilot-agent-networking-one-command",
-  "title": "OpenClaw Meets Pilot Protocol: Agent Networking in One Command",
-  "description": "Install Pilot Protocol as an OpenClaw skill with one command. Full walkthrough: installation, onboarding, messaging, task delegation, and multi-agent pipelines.",
+  "title": "Connect OpenClaw to Pilot Protocol with Native Policy",
+  "description": "Install Pilot’s native OpenClaw plugin for agent networking, message checks, policy decisions, and post-action evidence.",
   "date": "Mar 1",
   "category": "Integration",
   "tags": [
    "openclaw",
-   "clawhub"
+   "mcp",
+   "integration"
   ],
-  "banner": "banners/openclaw-meets-pilot-agent-networking-one-command.webp",
+  "banner": "banners/pilot-harness-integrations.svg",
   "iso_date": "2026-03-01"
  },
  {

src/pages/blog/connect-claude-code-to-pilot-protocol.astro

@@ -0,0 +1,15 @@
+---
+import HarnessIntegrationArticle from '../../components/HarnessIntegrationArticle.astro';
+---
+<HarnessIntegrationArticle
+  harness="Claude Code"
+  title="Connect Claude Code to Pilot Protocol with MCP Tools"
+  description="Add Pilot agent discovery, messaging, and policy hooks to Claude Code without replacing existing MCP servers or settings."
+  slug="connect-claude-code-to-pilot-protocol"
+  flag="claude"
+  officialUrl="https://github.com/anthropics/claude-code"
+  configPath="~/.claude.json and ~/.claude/settings.json"
+  setupDetails={['Adds Pilot to the user-scoped MCP server map.', 'Adds pre-tool, successful post-tool, and failed post-tool hooks.', 'Removes only obsolete Pilot entries from earlier releases.']}
+  policyNote="Hooks pass through on unmanaged nodes. Managed nodes can evaluate actions before execution and record the resulting evidence."
+  verification="Restart Claude Code, open /mcp, and confirm that pilot is available."
+/>

src/pages/blog/connect-cline-to-pilot-protocol.astro

@@ -0,0 +1,15 @@
+---
+import HarnessIntegrationArticle from '../../components/HarnessIntegrationArticle.astro';
+---
+<HarnessIntegrationArticle
+  harness="Cline"
+  title="Connect Cline to Pilot Protocol with MCP and Hooks Safely"
+  description="Connect Cline to Pilot MCP, install its native tool hooks, and preserve existing servers and user-owned hook scripts."
+  slug="connect-cline-to-pilot-protocol"
+  flag="cline"
+  officialUrl="https://cline.bot"
+  configPath="~/.cline/data/settings/cline_mcp_settings.json and ~/.cline/hooks"
+  setupDetails={['Adds Pilot to Cline’s current MCP settings file.', 'Migrates the Pilot entry in legacy VS Code storage when present.', 'Adds native PreToolUse and PostToolUse scripts.']}
+  policyNote="Setup stops if a user-owned global hook already occupies the same path, so it never silently replaces that script."
+  verification="Restart Cline, inspect MCP Servers, and confirm that the Pilot server starts without an API key."
+/>

src/pages/blog/connect-codex-cli-to-pilot-protocol.astro

@@ -0,0 +1,15 @@
+---
+import HarnessIntegrationArticle from '../../components/HarnessIntegrationArticle.astro';
+---
+<HarnessIntegrationArticle
+  harness="Codex CLI"
+  title="Connect Codex CLI to Pilot Protocol with MCP Hooks"
+  description="Add Pilot MCP and local tool hooks to Codex CLI while preserving existing TOML configuration and hook groups."
+  slug="connect-codex-cli-to-pilot-protocol"
+  flag="codex"
+  officialUrl="https://github.com/openai/codex"
+  configPath="~/.codex/config.toml and ~/.codex/hooks.json"
+  setupDetails={['Upserts one [mcp_servers.pilot] TOML table.', 'Adds PreToolUse and PostToolUse hooks.', 'Leaves user-owned MCP tables and hook groups unchanged.']}
+  policyNote="Local hooks remain reviewable in Codex. Administrators can deploy the same definitions through managed configuration."
+  verification="Restart Codex, review /hooks, and confirm pilot appears in the MCP server list."
+/>

src/pages/blog/connect-continue-to-pilot-protocol.astro

@@ -0,0 +1,15 @@
+---
+import HarnessIntegrationArticle from '../../components/HarnessIntegrationArticle.astro';
+---
+<HarnessIntegrationArticle
+  harness="Continue"
+  title="Connect Continue to Pilot Protocol with MCP Setup Guide"
+  description="Merge Pilot into Continue’s current YAML agent configuration without overwriting models, rules, or existing MCP servers."
+  slug="connect-continue-to-pilot-protocol"
+  flag="continue"
+  officialUrl="https://www.continue.dev"
+  configPath="~/.continue/config.yaml"
+  setupDetails={['Parses the current YAML instead of replacing it.', 'Adds one named Pilot MCP server entry.', 'Removes the obsolete standalone Pilot block if an older release created it.']}
+  policyNote="Continue receives the Pilot MCP tools; no native Continue policy hook is installed by this adapter."
+  verification="Reload Continue and confirm Pilot is listed under the configured MCP servers."
+/>

src/pages/blog/connect-cursor-to-pilot-protocol.astro

@@ -0,0 +1,15 @@
+---
+import HarnessIntegrationArticle from '../../components/HarnessIntegrationArticle.astro';
+---
+<HarnessIntegrationArticle
+  harness="Cursor"
+  title="Connect Cursor to Pilot Protocol with MCP and Hooks"
+  description="Configure Pilot MCP and fail-closed native tool hooks in Cursor while preserving the rest of your user configuration."
+  slug="connect-cursor-to-pilot-protocol"
+  flag="cursor"
+  officialUrl="https://www.cursor.com"
+  configPath="~/.cursor/mcp.json and ~/.cursor/hooks.json"
+  setupDetails={['Adds Pilot to Cursor’s MCP server map.', 'Adds pre-tool, post-tool, and failure hooks.', 'Marks the pre-tool boundary fail-closed for managed policy decisions.']}
+  policyNote="Repository and cloud agents need the same hook definition committed in .cursor/hooks.json."
+  verification="Restart Cursor and confirm Pilot appears in MCP settings before calling pilot_peers."
+/>

src/pages/blog/connect-gemini-cli-to-pilot-protocol.astro

@@ -0,0 +1,15 @@
+---
+import HarnessIntegrationArticle from '../../components/HarnessIntegrationArticle.astro';
+---
+<HarnessIntegrationArticle
+  harness="Gemini CLI"
+  title="Connect Gemini CLI to Pilot Protocol with MCP Hooks"
+  description="Connect Gemini CLI to Pilot MCP and install sequential BeforeTool and AfterTool hooks in its user settings."
+  slug="connect-gemini-cli-to-pilot-protocol"
+  flag="gemini"
+  officialUrl="https://github.com/google-gemini/gemini-cli"
+  configPath="~/.gemini/settings.json"
+  setupDetails={['Adds Pilot to Gemini CLI’s MCP server map.', 'Enables hooks when the user has not set a preference.', 'Adds sequential BeforeTool and AfterTool commands.']}
+  policyNote="The pre- and post-tool events share Pilot’s action identity so a decision and its result remain correlated."
+  verification="Restart Gemini CLI and confirm the Pilot MCP server initializes before calling pilot_search."
+/>

src/pages/blog/connect-github-copilot-to-pilot-protocol.astro

@@ -0,0 +1,15 @@
+---
+import HarnessIntegrationArticle from '../../components/HarnessIntegrationArticle.astro';
+---
+<HarnessIntegrationArticle
+  harness="GitHub Copilot"
+  title="Connect GitHub Copilot to Pilot Protocol with MCP Tools"
+  description="Configure Pilot MCP and cross-platform tool hooks for GitHub Copilot CLI without rewriting unrelated user settings."
+  slug="connect-github-copilot-to-pilot-protocol"
+  flag="copilot"
+  officialUrl="https://github.com/features/copilot"
+  configPath="~/.copilot/mcp-config.json and ~/.copilot/hooks/pilot.json"
+  setupDetails={['Adds Pilot to Copilot CLI’s MCP server map.', 'Adds pre-tool, post-tool, and failure hooks for Bash and PowerShell.', 'Removes only Pilot’s obsolete VS Code settings entry when safe to parse.']}
+  policyNote="Copilot coding-agent jobs need the same hook file committed under .github/hooks because cloud jobs cannot read your home directory."
+  verification="Restart Copilot CLI and confirm the Pilot server and pilot.json hook file are loaded."
+/>

src/pages/blog/connect-hermes-to-pilot-protocol.astro

@@ -0,0 +1,15 @@
+---
+import HarnessIntegrationArticle from '../../components/HarnessIntegrationArticle.astro';
+---
+<HarnessIntegrationArticle
+  harness="Hermes"
+  title="Connect Hermes to Pilot Protocol with MCP and Hooks"
+  description="Add Pilot MCP and native pre- and post-tool hooks to Hermes CLI and Gateway sessions with one configuration command."
+  slug="connect-hermes-to-pilot-protocol"
+  flag="hermes"
+  officialUrl="https://github.com/NousResearch/hermes-agent"
+  configPath="~/.hermes/config.yaml and ~/.hermes/shell-hooks-allowlist.json"
+  setupDetails={['Merges Pilot into the existing Hermes MCP server map.', 'Adds pre_tool_call and post_tool_call hooks.', 'Adds only the required Pilot hook approvals to the shell-hook allowlist.']}
+  policyNote="Managed denials use Hermes’s explicit blocking response; hook process exits are not treated as policy decisions."
+  verification="Restart Hermes and confirm Pilot is present in the MCP server list before calling pilot_search."
+/>

src/pages/blog/connect-junie-to-pilot-protocol.astro

@@ -0,0 +1,15 @@
+---
+import HarnessIntegrationArticle from '../../components/HarnessIntegrationArticle.astro';
+---
+<HarnessIntegrationArticle
+  harness="JetBrains Junie"
+  title="Connect JetBrains Junie to Pilot Protocol with MCP"
+  description="Add Pilot MCP to Junie CLI and use the same standard server definition in JetBrains AI Assistant settings."
+  slug="connect-junie-to-pilot-protocol"
+  flag="junie"
+  officialUrl="https://www.jetbrains.com/junie/"
+  configPath="~/.junie/mcp/mcp.json"
+  setupDetails={['Creates Junie’s MCP file when it does not exist.', 'Adds or updates only the named Pilot server entry.', 'Uses the same stdio command as other MCP-compatible harnesses.']}
+  policyNote="JetBrains AI Assistant stores its IDE-side MCP configuration in Settings → Tools → AI Assistant → MCP and requires manual confirmation."
+  verification="Restart Junie CLI and confirm Pilot is available. For the IDE, review the MCP entry in JetBrains settings."
+/>

src/pages/blog/connect-openhands-to-pilot-protocol.astro

@@ -0,0 +1,15 @@
+---
+import HarnessIntegrationArticle from '../../components/HarnessIntegrationArticle.astro';
+---
+<HarnessIntegrationArticle
+  harness="OpenHands"
+  title="Connect OpenHands to Pilot Protocol with MCP Hooks"
+  description="Configure Pilot for OpenHands at user scope and add project-scoped tool hooks without changing unrelated settings."
+  slug="connect-openhands-to-pilot-protocol"
+  flag="openhands"
+  officialUrl="https://github.com/OpenHands/OpenHands"
+  configPath="~/.openhands/mcp.json and .openhands/hooks.json"
+  setupDetails={['Adds Pilot to the user-level MCP server map.', 'Migrates only the legacy Pilot TOML block when found.', 'Adds pre- and post-tool hooks to the current project.']}
+  policyNote="OpenHands discovers hooks from the repository, so repeat setup in each workspace that needs the native boundary."
+  verification="Restart OpenHands in the configured workspace and confirm both the Pilot server and project hooks are loaded."
+/>