From 11d566cf05dba9051c4a7675fe1035ea8ba2cb9f Mon Sep 17 00:00:00 2001 From: Steve Calvert Date: Wed, 2 Sep 2026 13:41:44 -0700 Subject: [PATCH] docs: broaden Claude plugin surface guidance --- overrides/claude/root/README.md | 31 ++++++++++++++++++++++++++----- pluginpack.config.ts | 2 +- shared/glean/README.md | 30 +++++++++++++++++++----------- 3 files changed, 46 insertions(+), 17 deletions(-) diff --git a/overrides/claude/root/README.md b/overrides/claude/root/README.md index 2a9ec96..c344e06 100644 --- a/overrides/claude/root/README.md +++ b/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]` diff --git a/pluginpack.config.ts b/pluginpack.config.ts index f3249b5..384d0ae 100644 --- a/pluginpack.config.ts +++ b/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: { diff --git a/shared/glean/README.md b/shared/glean/README.md index af0060f..1098ac7 100644 --- a/shared/glean/README.md +++ b/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