docs: broaden Claude plugin surface guidance

overrides/claude/root/README.md

@@ -1,16 +1,27 @@
-# Glean Plugins for Claude Code
+# Glean Plugins for Claude
 
 > **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 down automatically.
 
-Official Glean plugins for [Claude Code](https://claude.com/claude-code) —
-enterprise knowledge, search, people, code, and meetings, right in your
-development workflow.
+Official Glean plugins for [Claude](https://claude.com) — enterprise knowledge,
+search, people, code, and meetings.
+
+> **Surface support:** The shared skills are designed to work across Claude Code,
+Claude Desktop chat, and Claude Cowork. Hooks and supporting agents require host
+support: Claude Code and Cowork support them, while Claude Desktop chat does not
+run them. The plugin provides a local Glean MCP server where the host supports
+bundled MCP; otherwise, configure the remote server in the host's MCP settings.
+The automated checks validate package structure, not full runtime parity in every
+host.
 
 ## ⚠️ v3.0.0 — plugins consolidated (one-time migration)
 
+The commands below are for Claude Code. In Claude Desktop or Cowork, use
+**Customize → Plugins** to remove the old marketplace and install the consolidated
+**Glean** plugin instead.
+
 The nine area-specific plugins (`glean-core`, `glean-search`, `glean-people`,
 `glean-meetings`, `glean-docs`, `glean-code`, `glean-skills`,
 `glean-productivity`, `glean-project`) are now a **single `glean` plugin**. Same
@@ -51,6 +62,8 @@ Restart Claude Code if prompted. `glean` carries everything the old plugins did.
 
 ## Quick start (new install)
 
+### Claude Code
+
 ```
 /plugin marketplace add gleanwork/claude-plugins
 /plugin install glean@glean-plugins
@@ -60,6 +73,14 @@ Restart Claude Code if prompted. `glean` carries everything the old plugins did.
 Then set up Glean by prompting the harness, for example: `Set up Glean for me`.
 Complete the browser OAuth flow when prompted. Skills auto-trigger by task.
 
+### Claude Desktop or Cowork
+
+Open **Customize → Plugins**, choose **Add marketplace**, and add
+`gleanwork/claude-plugins`. Install **Glean** and **Glean Developer Docs**.
+
+Then ask Claude to `Set up Glean for me` and complete the browser OAuth flow
+when prompted. Skills auto-trigger by task.
+
 ## Plugins
 
 | Plugin | Description |
@@ -69,7 +90,7 @@ Complete the browser OAuth flow when prompted. Skills auto-trigger by task.
 
 ## Requirements
 
-- [Claude Code](https://claude.com/claude-code) (latest version)
+- A current Claude host that supports plugins: [Claude Code](https://claude.com/claude-code), [Claude Desktop](https://claude.com/download), or [Claude Cowork](https://claude.com/product/cowork)
 - A Glean account with MCP access
 - Your Glean MCP server URL (find it at [app.glean.com/admin/about-glean](https://app.glean.com/admin/about-glean)); format: `[server-url]/mcp/[server-name]`
 

pluginpack.config.ts

@@ -22,7 +22,7 @@ export default defineConfig({
       repositoryFiles: "overrides/claude/root",
       manifest: {
         description:
-          "Official Glean plugins for Claude Code — enterprise knowledge, search, people, code, and meetings.",
+          "Official Glean plugins for Claude — enterprise knowledge, search, people, code, and meetings.",
       },
       plugins: {
         glean: {

shared/glean/README.md

@@ -1,19 +1,24 @@
-# Glean for Claude Code
+# Glean
 
-Official Glean plugin for [Claude Code](https://claude.com/claude-code) — enterprise search,
-code exploration, and people discovery directly in your development workflow.
+Official Glean plugin for supported AI hosts — enterprise search, code
+exploration, and people discovery in your development workflow.
 
 ## Setup
 
 ### 1. Install the plugin
 
-Install from the Claude Code plugin marketplace.
+Install from your host's plugin marketplace. This plugin's shared skills work
+across Claude Code, Claude Desktop chat, Claude Cowork, Cursor, and Codex; hooks
+and supporting agents depend on host support.
 
 ### 2. Set up Glean
 
-Start Claude Code and prompt the harness to set up Glean, for example: `Set up
-Glean for me`. Complete the browser OAuth flow when prompted, then return to
-Claude Code.
+Use the host's Glean setup flow. In Claude Code or Cowork, prompt the harness,
+for example: `Set up Glean for me`, then complete the browser OAuth flow when
+prompted. For hosts that do not start the bundled local server, register the
+Glean MCP endpoint in the host's MCP configuration and follow that host's
+authentication flow. Some hosts, such as Codex, require an explicit MCP login
+step.
 
 ## What's Included
 
@@ -28,14 +33,17 @@ by task — there's no per-skill install. They cover:
 - **Personal productivity** — summarize your own activity, prep status updates, and surface what needs your attention.
 - **Skill authoring** — discover automation opportunities and generate new skills.
 
-The plugin provides a local Glean MCP server. If no Glean tools are visible,
-ask the user to set up Glean by prompting the harness (for example, `Set up
-Glean for me`).
+The plugin provides a local Glean MCP server where the host supports bundled
+MCP. If no Glean tools are visible, use the host's Glean setup flow described
+above. Otherwise, Glean tools use whatever Glean MCP server is connected in the
+current host.
 
 ## Requirements
 
-- [Claude Code](https://claude.com/claude-code) (latest version)
+- A current supported AI host that supports plugins and MCP
 - A Glean account with MCP access
+- A Glean MCP endpoint if your host requires remote configuration (get it from
+  the [Glean admin settings](https://app.glean.com/admin/about-glean))
 
 ## Support