steve-calvert-glean · Oct 21, 2026 · Oct 22, 2026
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -51,6 +51,9 @@ jobs:
             repo: cursor-plugins
           - target: codex
             repo: codex-plugins
+          # Agent Plugins packages with a Codex and a Copilot marketplace.
+          - target: agent-plugins
+            repo: glean-plugins
     concurrency:
       group: pluginpack-sync-${{ matrix.target }}
       cancel-in-progress: true

diff --git a/README.md b/README.md
@@ -44,6 +44,10 @@ Nothing under `shared/` ships implicitly. Each emitted plugin names its shared
 - **Codex** — a marketplace + an [Agent Plugins](https://agent-plugins.org/specification)
   package for each plugin: a root `plugin.json` with Codex's install-surface
   metadata under `extensions["com.openai"]`, `mcp.json`, and bundled skills.
+- **Agent Plugins** — the same portable packages for any client that supports
+  the format, with a marketplace for Codex (`.agents/plugins/marketplace.json`)
+  and GitHub Copilot (`.github/plugin/marketplace.json`). Copilot's custom
+  agents ship in each package's `com.github.copilot/agents/`.
 
 Skills use the open Agent Skills format — `SKILL.md` with `name`/`description`
 frontmatter and optional `references/` loaded on demand — which Claude Code,
@@ -91,4 +95,5 @@ In this repo the skill markdown _is_ the shipped product, so:
 ### Releasing
 
 See [`RELEASE.md`](./RELEASE.md) for how to cut a release and how that flows
-into the `claude-plugins`, `cursor-plugins`, and `codex-plugins` repos.
+into the `claude-plugins`, `cursor-plugins`, `codex-plugins`, and
+`glean-plugins` repos.
diff --git a/RELEASE.md b/RELEASE.md
@@ -38,6 +38,20 @@ release is what triggers the actual plugin distribution (below).
   npm install
   ```
 
+- Test the Agent Plugins output in real clients before you release. Sync
+  without a release, then install from the `glean-plugins` sync branch:
+
+  ```sh
+  gh workflow run publish.yml --repo gleanwork/agent-plugins -f mode=sync
+  npm run e2e:install -- --source gleanwork/glean-plugins --ref pluginpack/sync-agent-plugins
+  ```
+
+  `e2e:install` installs both plugins in Codex and GitHub Copilot CLI, each
+  with a throwaway home, and checks the skills, the Copilot agents and that
+  the Glean MCP server lists its tools. Run it with no options to test a
+  local `npm run build` instead. It doesn't sign in to Glean, so also check a
+  signed-in session by hand.
+
 ## Release
 
 - `release-it`'s GitHub plugin needs a token with `repo` scope to create the
@@ -77,11 +91,12 @@ release is what triggers the actual plugin distribution (below).
 Publishing the GitHub Release triggers
 [`.github/workflows/publish.yml`](./.github/workflows/publish.yml), which:
 
-1. Rebuilds and validates all 3 targets (`claude`, `cursor`, `codex`).
+1. Rebuilds and validates all 4 targets (`claude`, `cursor`, `codex`,
+   `agent-plugins`).
 2. Opens — or force-updates — one PR per target in that target's output
    repo (`gleanwork/claude-plugins`, `gleanwork/cursor-plugins`,
-   `gleanwork/codex-plugins`), on a machine-owned `pluginpack/sync-<target>`
-   branch labeled `pluginpack-sync`.
+   `gleanwork/codex-plugins`, `gleanwork/glean-plugins`), on a machine-owned
+   `pluginpack/sync-<target>` branch labeled `pluginpack-sync`.
 
 Those PRs are regenerated and force-pushed on every sync — **don't push to
 them by hand or hand-edit their content**. Review and merge each one in its

diff --git a/overrides/agent-plugins/glean-dev-docs/README.md b/overrides/agent-plugins/glean-dev-docs/README.md
@@ -0,0 +1,44 @@
+# Glean Developer Docs
+
+Search the public [Glean developer documentation](https://docs.glean.com) — APIs, SDKs,
+MCP, authentication, indexing, and integration guides for building *with* Glean.
+
+This is a separate, focused plugin for people building on the Glean platform. For
+searching your own company's internal knowledge, use the main **Glean** plugin instead.
+
+## Setup
+
+### 1. Install the plugin
+
+Install `glean-dev-docs@glean-plugins` from the `gleanwork/glean-plugins`
+marketplace in Codex or GitHub Copilot CLI.
+
+### 2. Configure the Glean Dev Docs MCP server
+
+This plugin uses the public Glean Developer Docs MCP server. No Glean account
+is required. Add it with:
+
+```bash
+# Codex
+codex mcp add glean-dev-docs --url https://developers.glean.com/mcp
+
+# GitHub Copilot CLI
+copilot mcp add --transport http glean-dev-docs https://developers.glean.com/mcp
+```
+
+Start a new session so the MCP tools are available.
+
+## What's Included
+
+A single skill that auto-triggers when you ask about building with Glean — API
+syntax, SDK usage, MCP setup, indexing, authentication, and platform integration.
+It searches the public developer documentation and returns cited answers.
+
+## Support
+
+- [Glean Developer Documentation](https://docs.glean.com)
+- [GitHub Issues](https://github.com/gleanwork/agent-plugins/issues)
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
diff --git a/overrides/agent-plugins/glean-dev-docs/assets/avatar.png b/overrides/agent-plugins/glean-dev-docs/assets/avatar.png
diff --git a/overrides/agent-plugins/glean/LICENSE b/overrides/agent-plugins/glean/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Glean
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/overrides/agent-plugins/glean/README.md b/overrides/agent-plugins/glean/README.md
@@ -0,0 +1,62 @@
+# Glean
+
+Official Glean plugin in the [Agent Plugins](https://agent-plugins.org/specification)
+format — enterprise search, code exploration, and people discovery directly in
+your development workflow. Works in Codex and GitHub Copilot CLI.
+
+## Setup
+
+### 1. Install the plugin
+
+Codex:
+
+```bash
+codex plugin marketplace add gleanwork/glean-plugins
+codex plugin add glean@glean-plugins
+```
+
+GitHub Copilot CLI:
+
+```bash
+copilot plugin marketplace add gleanwork/glean-plugins
+copilot plugin install glean@glean-plugins
+```
+
+### 2. Set up Glean
+
+Start a new session and prompt the harness: `Set up Glean for me`. Complete
+the browser OAuth flow when prompted, then start a new session so both the
+bundled skills and Glean MCP tools are available.
+
+## What's Included
+
+The plugin ships a library of skills that auto-trigger by task — there's no
+per-skill install. They cover:
+
+- **Enterprise search & knowledge** — find documents, Slack messages, and email; vet results for freshness and authority.
+- **Code across repos** — explore implementations, find usage examples and similar code, identify code owners, and gather architectural context.
+- **People & org** — find experts by contribution, and identify stakeholders for a change or project.
+- **Meetings** — prep for upcoming meetings and catch up on what you missed.
+- **Onboarding & projects** — ramp up on a team or area, read quick project status, and generate comprehensive project handoffs.
+- **Personal productivity** — summarize your own activity, prep status updates, and surface what needs your attention.
+- **Skill authoring** — discover automation opportunities and generate new skills.
+
+In Copilot, the plugin also adds custom agents for focused research tasks,
+such as people discovery and meeting analysis.
+
+## Requirements
+
+- A client that supports Agent Plugins, such as
+  [Codex](https://developers.openai.com/codex) or
+  [GitHub Copilot CLI](https://docs.github.com/copilot/how-tos/copilot-cli)
+- A Glean account with MCP access
+
+## Support
+
+- [Glean MCP Documentation](https://docs.glean.com/mcp)
+- [Glean Support](https://help.glean.com)
+- [GitHub Issues](https://github.com/gleanwork/agent-plugins/issues)
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
diff --git a/overrides/agent-plugins/glean/assets/avatar.png b/overrides/agent-plugins/glean/assets/avatar.png
diff --git a/overrides/agent-plugins/glean/mcp/config.json b/overrides/agent-plugins/glean/mcp/config.json
@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "glean_plugin": {
+      "command": "node",
+      "args": ["./mcp/start.mjs"],
+      "env": {
+        "ENABLE_HITL": "true",
+        "HITL_TIMEOUT_MS": "300000"
+      }
+    }
+  }
+}
diff --git a/overrides/agent-plugins/root/LICENSE b/overrides/agent-plugins/root/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Glean
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/overrides/agent-plugins/root/README.md b/overrides/agent-plugins/root/README.md
@@ -0,0 +1,73 @@
+# Glean Plugins
+
+> **Generated repository.** Built from
+> [gleanwork/agent-plugins](https://github.com/gleanwork/agent-plugins) via
+> [pluginpack](https://github.com/gleanwork/pluginpack). Don't hand-edit managed
+> files here — changes are made in `agent-plugins` and synced through generated
+> pull requests.
+
+Official Glean plugins in the [Agent Plugins](https://agent-plugins.org/specification)
+format — enterprise knowledge, search, people, code, meetings, and Glean
+developer docs. One package per plugin works in every client that supports the
+format.
+
+## Install
+
+### Codex
+
+```bash
+codex plugin marketplace add gleanwork/glean-plugins
+codex plugin add glean@glean-plugins
+codex plugin add glean-dev-docs@glean-plugins
+```
+
+### GitHub Copilot CLI
+
+```bash
+copilot plugin marketplace add gleanwork/glean-plugins
+copilot plugin install glean@glean-plugins
+copilot plugin install glean-dev-docs@glean-plugins
+```
+
+Then start a new session and prompt the harness to set up Glean, for example:
+`Set up Glean for me`. Complete the browser OAuth flow when prompted.
+
+The **Glean developer docs** plugin uses a separate public MCP server. If you
+installed that plugin, add it before starting a new session:
+
+```bash
+codex mcp add glean-dev-docs --url https://developers.glean.com/mcp
+copilot mcp add --transport http glean-dev-docs https://developers.glean.com/mcp
+```
+
+## Plugins
+
+| Plugin | Description |
+|--------|-------------|
+| **[glean](plugins/glean)** | Enterprise knowledge — search docs/Slack/email, cross-repo code exploration, people & experts, meetings, onboarding, and productivity. |
+| **[glean-dev-docs](plugins/glean-dev-docs)** | Search Glean's public developer documentation — APIs, SDKs, MCP, and integration guides. |
+
+## Layout
+
+- `plugins/<name>/` — one Agent Plugins package per plugin: `plugin.json`,
+  `mcp.json`, and `skills/`. Copilot's custom agents are in
+  `plugins/glean/com.github.copilot/agents/`.
+- `.agents/plugins/marketplace.json` — the Codex marketplace.
+- `.github/plugin/marketplace.json` — the Copilot marketplace.
+
+## Requirements
+
+- A client that supports Agent Plugins, such as
+  [Codex](https://developers.openai.com/codex) or
+  [GitHub Copilot CLI](https://docs.github.com/copilot/how-tos/copilot-cli)
+- A Glean account with MCP access (for the `glean` plugin)
+
+## Support
+
+- [Glean MCP Documentation](https://docs.glean.com/mcp)
+- [Glean Support](https://help.glean.com)
+- [GitHub Issues](https://github.com/gleanwork/agent-plugins/issues)
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.
diff --git a/package.json b/package.json
@@ -13,13 +13,14 @@
     "build": "pluginpack build && npm run check:plugin-changelogs",
     "build:bundle": "node shared/glean/mcp/build.mjs",
     "clean": "pluginpack clean",
+    "e2e:install": "node scripts/e2e-install.mjs",
     "check:no-shell": "node scripts/check-no-shell-scripts.mjs",
     "check:plugin-changelogs": "node scripts/check-plugin-changelogs.mjs",
     "check:release-version": "node scripts/check-release-version.mjs",
     "prune": "pluginpack prune",
     "typecheck:bundle": "tsc --noEmit -p shared/glean/mcp/tsconfig.json",
     "test:bundle": "vitest run --root shared/glean/mcp",
-    "validate": "pluginpack validate --target claude --dir dist/claude && pluginpack validate --target cursor --dir dist/cursor && pluginpack validate --target codex --dir dist/codex",
+    "validate": "pluginpack validate --target claude --dir dist/claude && pluginpack validate --target cursor --dir dist/cursor && pluginpack validate --target codex --dir dist/codex && pluginpack validate --target agent-plugins --dir dist/agent-plugins",
     "test": "npm run build && npm run validate",
     "prebuild": "node scripts/sync-plugin-changelogs.mjs && npm run build:bundle",
     "release": "release-it"