Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
"email": "steve.calvert@glean.com"
},
"metadata": {
"description": "Official Glean plugin for Cursor — enterprise knowledge, code search, and people discovery.",
"description": "Official Glean plugins for Cursor — enterprise knowledge, code search, and people discovery.",
"keywords": [
"glean",
"enterprise-search",
Expand All @@ -19,8 +19,13 @@
{
"name": "glean",
"source": "glean",
"description": "Official Glean plugin for Cursor — enterprise search, code exploration, and people discovery."
"description": "Official Glean plugin — search documents, Slack, and email; explore code across repos; find experts and stakeholders; prep for meetings and onboarding."
},
{
"name": "glean-dev-docs",
"source": "glean-dev-docs",
"description": "Search the public Glean developer documentation — APIs, SDKs, MCP, and integration guides for building with Glean."
}
],
"version": "2.1.1"
"version": "3.0.0"
}
20 changes: 0 additions & 20 deletions .github/workflows/validate-plugins.yml

This file was deleted.

68 changes: 68 additions & 0 deletions .pluginpack/cursor.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
{
"version": 1,
"target": "cursor",
"files": [
".cursor-plugin/marketplace.json",
"README.md",
"glean-dev-docs/.cursor-plugin/plugin.json",
"glean-dev-docs/CHANGELOG.md",
"glean-dev-docs/LICENSE",
"glean-dev-docs/README.md",
"glean-dev-docs/skills/dev-docs-guide/SKILL.md",
"glean/.cursor-plugin/plugin.json",
"glean/CHANGELOG.md",
"glean/LICENSE",
"glean/README.md",
"glean/agents/activity-analyzer.md",
"glean/agents/codebase-navigator.md",
"glean/agents/doc-reader.md",
"glean/agents/enterprise-searcher.md",
"glean/agents/meeting-analyzer.md",
"glean/agents/people-finder.md",
"glean/agents/plan-prep-researcher.md",
"glean/agents/project-synthesizer.md",
"glean/agents/skill-generator.md",
"glean/agents/work-pattern-analyzer.md",
"glean/assets/avatar.png",
"glean/assets/avatar.svg",
"glean/rules/glean-result-vetting.mdc",
"glean/rules/glean-tool-selection.mdc",
"glean/skills/catch-up/SKILL.md",
"glean/skills/code-owners/SKILL.md",
"glean/skills/codebase-context/SKILL.md",
"glean/skills/connect-glean/SKILL.md",
"glean/skills/find-examples/SKILL.md",
"glean/skills/find-expert/SKILL.md",
"glean/skills/meeting-prep/SKILL.md",
"glean/skills/onboarding/SKILL.md",
"glean/skills/plan-prep/SKILL.md",
"glean/skills/project-awareness/SKILL.md",
"glean/skills/project-handoff/SKILL.md",
"glean/skills/search/SKILL.md",
"glean/skills/similar-code/SKILL.md",
"glean/skills/skill-creation-guide/SKILL.md",
"glean/skills/stakeholders/SKILL.md",
"glean/skills/using-glean-code/SKILL.md",
"glean/skills/using-glean-code/reference/exploration.md",
"glean/skills/using-glean-code/reference/plan-prep.md",
"glean/skills/using-glean-productivity/SKILL.md",
"glean/skills/using-glean-productivity/reference/activity.md",
"glean/skills/using-glean-productivity/reference/priorities.md",
"glean/skills/using-glean/SKILL.md",
"glean/skills/using-glean/reference/agents-as-tools.md",
"glean/skills/using-glean/reference/chat.md",
"glean/skills/using-glean/reference/code-search.md",
"glean/skills/using-glean/reference/employee-search.md",
"glean/skills/using-glean/reference/gmail-search.md",
"glean/skills/using-glean/reference/knowledge-graph.md",
"glean/skills/using-glean/reference/meeting-lookup.md",
"glean/skills/using-glean/reference/memory.md",
"glean/skills/using-glean/reference/outlook-search.md",
"glean/skills/using-glean/reference/read-document.md",
"glean/skills/using-glean/reference/search.md",
"glean/skills/using-glean/reference/synthesis.md",
"glean/skills/using-glean/reference/user-activity.md",
"glean/skills/using-glean/reference/vetting.md",
"glean/skills/verify-rfc/SKILL.md"
]
}
35 changes: 0 additions & 35 deletions .release-it.json

This file was deleted.

56 changes: 23 additions & 33 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,45 +1,35 @@
# Glean Plugins for Cursor

[![GA](https://img.shields.io/badge/-GA-F6F3EB?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB2aWV3Qm94PSIwIDAgMzIgMzIiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CjxwYXRoIGQ9Ik0yNC4zMDA2IDIuOTU0MjdMMjAuNzY1NiAwLjE5OTk1MUwxNy45MDI4IDMuOTk1MjdDMTMuNTY1MyAxLjkzNDk1IDguMjMwMTkgMy4wODQzOSA1LjE5Mzk0IDcuMDA5ODNDMS42NTg4OCAxMS41NjQyIDIuNDgzIDE4LjExMzggNy4wMzczOCAyMS42NDg5QzguNzcyMzggMjIuOTkzNSAxMC43ODkzIDIzLjcwOTIgMTIuODI3OSAyMy44MTc3QzE2LjE0NjEgMjQuMDEyOCAxOS41MDc3IDIyLjYyNDggMjEuNjc2NSAxOS44MDU1QzI0LjczNDQgMTUuODggMjQuNTE3NSAxMC40MTQ4IDIxLjQ1OTYgNi43Mjc4OUwyNC4zMDA2IDIuOTU0MjdaTTE4LjExOTcgMTcuMDUxMkMxNi4xMDI4IDE5LjYzMiAxMi4zNzI1IDIwLjEwOTEgOS43NzAwMSAxOC4wOTIyQzcuMTg5MTkgMTYuMDc1MiA2LjcxMjA3IDEyLjMyMzMgOC43MjkwMSA5Ljc0MjQ2QzkuNzA0OTQgOC40ODQ1OCAxMS4xMTQ2IDcuNjgyMTQgMTIuNjc2MSA3LjQ4Njk2QzEzLjA0NDggNy40NDM1OCAxMy40MTM1IDcuNDIxOSAxMy43ODIyIDcuNDQzNThDMTQuOTc1IDcuNTA4NjUgMTYuMTI0NCA3Ljk0MjM5IDE3LjA3ODcgOC42Nzk3N0MxOS42NTk1IDEwLjcxODQgMjAuMTM2NiAxNC40NzAzIDE4LjExOTcgMTcuMDUxMloiIGZpbGw9IndoaXRlIi8+CjxwYXRoIGQ9Ik0yNC41MTc2IDIxLjY5MjJDMjMuOTMyIDIyLjQ1MTMgMjMuMjgxNCAyMy4xMjM2IDIyLjU2NTcgMjMuNzUyNUMyMS44NzE3IDI0LjMzODEgMjEuMTEyNyAyNC44ODAzIDIwLjMxMDIgMjUuMzM1N0MxOS41Mjk1IDI1Ljc2OTUgMTguNjgzNyAyNi4xMzgyIDE3LjgzNzggMjYuNDIwMUMxNi45OTIgMjYuNzAyIDE2LjEwMjggMjYuODk3MiAxNS4yMTM3IDI3LjAwNTdDMTQuMzI0NSAyNy4xMTQxIDEzLjQzNTMgMjcuMTU3NSAxMi41MjQ0IDI3LjA5MjRDMTEuNjEzNSAyNy4wMjczIDEwLjcyNDMgMjYuODc1NSA5Ljg1Njg0IDI2LjY1ODdMOS42NjE2NSAyNy4zNzQzTDguNzcyNDYgMzAuOTk2MkM5LjkwMDIxIDMxLjI5OTggMTEuMDQ5NyAzMS40NzMzIDEyLjIyMDggMzEuNTZDMTIuMjY0MiAzMS41NiAxMi4zMjkyIDMxLjU2IDEyLjM3MjYgMzEuNTZDMTMuNTAwMyAzMS42MjUxIDE0LjY0OTggMzEuNTgxNyAxNS43NTU4IDMxLjQ1MTZDMTYuOTI3IDMxLjI5OTggMTguMDk4MSAzMS4wMzk1IDE5LjIyNTggMzAuNjcwOEMyMC4zNTM2IDMwLjMwMjIgMjEuNDU5NyAyOS44MjUgMjIuNTAwNyAyOS4yMzk1QzIzLjU2MzQgMjguNjUzOSAyNC41NjEgMjcuOTM4MiAyNS40OTM1IDI3LjE1NzVDMjYuNDQ3OCAyNi4zNTUgMjcuMzE1MyAyNS40NDQyIDI4LjA3NDQgMjQuNDQ2NUMyOC4xODI4IDI0LjMxNjQgMjguMjY5NSAyNC4xNjQ2IDI4LjM3OCAyNC4wMTI4TDI0Ljc3NzkgMjEuMzQ1MkMyNC42Njk0IDIxLjQ1MzcgMjQuNjA0NCAyMS41ODM4IDI0LjUxNzYgMjEuNjkyMloiIGZpbGw9IndoaXRlIi8+Cjwvc3ZnPg==&labelColor=343CED)](https://github.com/gleanwork/.github/blob/main/docs/repository-stability.md#ga)
> **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 [Cursor](https://cursor.com), enabling enterprise knowledge integration directly in your development workflow.
Official Glean plugins for [Cursor](https://cursor.com) — enterprise knowledge,
search, code exploration, and people discovery, right in your editor.

## Quick Start
## What's new in v3.0.0

Install from the [Cursor marketplace](https://cursor.com/marketplace/glean).
- The **`glean`** plugin is refreshed with the latest consolidated skills and
agents (search, code exploration, people, meetings, onboarding, productivity).
Your existing `glean` install updates in place — no migration needed.
- A new **`glean-dev-docs`** plugin searches Glean's public developer
documentation (APIs, SDKs, MCP) — install it if you build *with* Glean.

Then configure your Glean MCP connection — visit the [Glean MCP configurator](https://app.glean.com/settings/install?mcpConfigure=true&mcpHost=cursor) to get your server URL, then add it to `~/.cursor/mcp.json`:
## Install

```json
{
"mcpServers": {
"glean": {
"url": "YOUR-GLEAN-MCP-URL"
}
}
}
```
Add the **`gleanwork/cursor-plugins`** marketplace in Cursor, then install the
**`glean`** plugin (and **`glean-dev-docs`** if you build with Glean). Once
installed, ask Cursor to "set up Glean" and the `glean` plugin's `connect-glean`
skill walks you through connecting a Glean MCP server.

Restart Cursor after editing — OAuth authentication is handled automatically on first use.
## Plugins

## Plugin

| Plugin | Description | Docs |
| ------ | ----------- | ---- |
| **[glean](./glean)** | Enterprise search, code exploration, and people discovery | [README](./glean/README.md) |

## Requirements

- [Cursor](https://cursor.com) (latest version)
- A Glean account with MCP access
- Your Glean MCP server URL (get it from the [Glean MCP configurator](https://app.glean.com/settings/install?mcpConfigure=true&mcpHost=cursor))

## Support

- [Glean MCP Documentation](https://docs.glean.com/mcp)
- [Glean Support](https://help.glean.com)
- [GitHub Issues](https://github.com/gleanwork/cursor-plugins/issues)
| Plugin | Description |
|--------|-------------|
| **[glean](glean)** | Enterprise knowledge — search docs/Slack/email, cross-repo code exploration, people & experts, meetings, onboarding, productivity. |
| **[glean-dev-docs](glean-dev-docs)** | Search Glean's public developer documentation — APIs, SDKs, MCP, and integration guides. |

## License

MIT see [LICENSE](LICENSE) for details.
MIT License - see [LICENSE](LICENSE) for details.
15 changes: 15 additions & 0 deletions glean-dev-docs/.cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
{
"name": "glean-dev-docs",
"displayName": "Glean Developer Docs",
"version": "3.0.0",
"description": "Search the public Glean developer documentation — APIs, SDKs, MCP, and integration guides for building with Glean.",
"author": {
"name": "Glean",
"email": "steve.calvert@glean.com",
"url": "https://glean.com"
},
"homepage": "https://docs.glean.com/administration/platform/mcp/about",
"repository": "https://github.com/gleanwork/agent-plugins",
"license": "MIT",
"skills": "./skills/"
}
43 changes: 43 additions & 0 deletions glean-dev-docs/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Changelog

## 3.0.0 (2026-06-14)

### Features

* add connect-glean skill for Glean MCP setup ([45e6864](https://github.com/gleanwork/agent-plugins/commit/45e6864dd672aec90362e54d2c86891e04ffec7d))
* consolidate Glean agent plugins ([67c689e](https://github.com/gleanwork/agent-plugins/commit/67c689e0e6a5b008e35423638af9494e9a1c5c1f))
* consolidate sources, add skills authoring + project-handoff, scaffold release-it ([c79492c](https://github.com/gleanwork/agent-plugins/commit/c79492c9dc8fab8cd2c5aec4f098df488c09dce7))
* unify skills into one source compiled to one plugin per target ([0f60738](https://github.com/gleanwork/agent-plugins/commit/0f607387890a735fffc94b1742d2dd8debaa7a54))

### Bug Fixes

* bump create-github-app-token to v3 (Node 24) ([eb6183d](https://github.com/gleanwork/agent-plugins/commit/eb6183ddc294b965e87dc740cf09dd5b4705557b))
* pin node-version in publish workflow ([d3c91af](https://github.com/gleanwork/agent-plugins/commit/d3c91afd984d9f17981af7cc5a97eaca9c6bddc2))
* pin pluginpack-action by full commit SHA ([7624de5](https://github.com/gleanwork/agent-plugins/commit/7624de574a3864456bf398b8afedf4b453c965d2))
* read App ID from variable or secret ([0f02ecc](https://github.com/gleanwork/agent-plugins/commit/0f02ecc4465e56e8eefef2a4e0f0c2044771be3c))
* rev package.json on release via release-it ([9b36785](https://github.com/gleanwork/agent-plugins/commit/9b36785a38278d2e7f4f79f6ac52499ccec030a9))
* use client-id for create-github-app-token v3 ([1f949a3](https://github.com/gleanwork/agent-plugins/commit/1f949a3e5a5acab9ef3ca7ca511307b55c50ce75))

## [2.1.1](https://github.com/gleanwork/cursor-plugins/compare/v2.1.0...v2.1.1) (2026-03-17)

## [2.1.0](https://github.com/gleanwork/cursor-plugins/compare/v2.0.0...v2.1.0) (2026-02-26)

### Features

* update plugin category and keywords for Cursor marketplace ([7991c0e](https://github.com/gleanwork/cursor-plugins/commit/7991c0eeb31bac044d7750973c36ee9973e34a02))

## [2.0.0](https://github.com/gleanwork/cursor-plugins/compare/v1.0.0...v2.0.0) (2026-02-25)

## 1.0.0 (2026-02-21)

All notable changes to this project will be documented in this file.

## 0.1.0 (Unreleased)

### Features

- **glean-core**: Foundation plugin with 6 skills, 2 rules, and 2 commands
- **glean-search**: Enterprise search agent and command
- **glean-code**: Cross-repo code exploration with 2 agents and 5 commands
- **glean-people**: People finder agent and stakeholder discovery commands
- Validation script and CI workflow
22 changes: 22 additions & 0 deletions glean-dev-docs/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
MIT License

Copyright (c) 2024 Glean Technologies, Inc.

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.

33 changes: 33 additions & 0 deletions glean-dev-docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# 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 from your host's plugin marketplace (Claude Code or Cursor).

### 2. Configure the Glean Dev Docs MCP server

This plugin uses the public Glean Developer Docs MCP server. See your host's MCP
setup to add it; no Glean account is required.

## 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.
51 changes: 51 additions & 0 deletions glean-dev-docs/skills/dev-docs-guide/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
name: dev-docs-guide
description: Search the public Glean developer documentation for API, SDK, MCP, authentication, indexing, and integration details. Use when the user is building with Glean rather than searching internal company knowledge — trigger phrases include Glean API, Glean SDK, integrate with Glean, indexing API, Glean Python or JavaScript SDK, and how to authenticate with Glean. Don't use it for internal company knowledge, which the using-glean skill covers.
---

# Glean Developer Documentation Guide

When users ask about developing with Glean, use the Glean Developer Docs MCP tools.

## Tools

This skill uses two tools (refer to them by their bare names):

- `docs_search` — search across the public Glean developer documentation
- `docs_fetch` — get the full content of a documentation page by URL

If these tools aren't visible in the active inventory, the user hasn't configured the Glean Dev Docs MCP server for this host — point them at their host's Glean Dev Docs MCP setup.

## When to use

- **Glean API** — endpoints, authentication, rate limits
- **SDK usage** — Python, JavaScript installation and examples
- **MCP integration** — server configuration, tool capabilities
- **Platform concepts** — indexing, search configuration, connectors

## Tool selection

| Need | Tool | Example |
|---|---|---|
| Find relevant docs | `docs_search` | `docs_search "API authentication"` |
| Get implementation details | `docs_fetch` | `docs_fetch "https://developers.glean.com/docs/api/auth"` |

## Workflow

1. **Search first**: `docs_search "user query terms"`
2. **Review results**: identify the most relevant pages
3. **Fetch for details**: `docs_fetch "[url]"` for code examples
4. **Cite sources**: always include documentation URLs

## Query tips

Good: `"OAuth token refresh"`, `"Python SDK search API"`
Less effective: `"authentication"`, `"API"`, `"how to use"`

## Differentiating from enterprise Glean

This skill is for **public developer documentation**:
- How to build with Glean APIs / SDKs
- MCP configuration guides

For **internal company data** (Slack, email, internal docs), use the `using-glean` skill instead.
Loading