docs(claude-code): add install-first plugin guide - #646
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
Author
|
Hold merge until Plugin launch |
steve-calvert-glean
previously requested changes
Jul 31, 2026
eshwar-sundar-glean
force-pushed
the
eshwar/claude-code-plugin-page-v2
branch
from
August 13, 2026 05:38
0e2ac56 to
40bcfd7
Compare
eshwar-sundar-glean
marked this pull request as ready for review
August 13, 2026 05:44
![glean-it[bot]](https://avatars.githubusercontent.com/u/48140418?s=60&v=4){kind=small}
eshwar-sundar-glean
changed the title
david-hamilton-glean
approved these changes
Aug 13, 2026
david-hamilton-glean
left a comment
david-hamilton-glean
left a comment
Member
There was a problem hiding this comment.
One rendering issue to resolve but otherwise LGTM
| description: | ||
| "Connect the plugin to your Glean instance. Authentication uses Glean's OAuth server where enabled, or a Glean API token as a fallback. You only need to do this once per machine.", | ||
| items: [ | ||
| 'In Claude Code, run: `/glean_run setup my Glean`', |
Member
There was a problem hiding this comment.
2/5 (minor preference, non-blocking)
This doesn't actually render correctly.
Contributor
Author
There was a problem hiding this comment.
Fixed. The list-step renderer now accepts React nodes, and the setup command is rendered with a real <code> element instead of literal backticks. Verified in the flag-on SSR build: the command renders as <code>/glean_run setup my Glean</code>, with no literal-backtick text. — sent via Glean Pi
Contributor
Author
There was a problem hiding this comment.
addressed
david-hamilton-glean
dismissed
steve-calvert-glean’s stale review
August 13, 2026 22:44
Steve's comments were addressed.
Add an install-first Claude Code plugin guide behind the existing `claude-code-plugin-v2` feature flag. The previous page remains the fallback, so the new page can be enabled through the existing runtime flag configuration when the plugin is ready to launch. - Add a product-facing What's included section with the claude-plugins README link - Add marketplace installation and `/glean_run setup my Glean` instructions - Render the setup command as inline code in the rich list-step renderer - Document OAuth/API-token authentication and optional USE_CLAUDE_PROJECT_DIR settings for fewer skill-file permission prompts - Add optional whatsIncluded and afterSteps slots to PluginPage
eshwar-sundar-glean
force-pushed
the
eshwar/claude-code-plugin-page-v2
branch
from
August 17, 2026 18:46
40bcfd7 to
b070cd0
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates
/guides/mcp/claude-codewith an install-first experience for the Glean Claude Code plugin, gated behind the existingclaude-code-plugin-v2feature flag.The previous page is preserved as the fallback and remains visible while the flag is off. The new page can be enabled through the existing runtime feature-flag configuration when the plugin is ready to launch.
New page
claude-pluginsREADME for more detail about the plugin contents./glean_run setup my Glean.USE_CLAUDE_PROJECT_DIR=1, Claude Codesettings.jsonscopes, and the.claude/tmp/.gitignoreentry.Implementation
whatsIncludedandafterStepsslots toPluginPage; existing plugin pages are unaffected.claude-code-plugin-v2off when absent; no new default-flag mechanism is introduced.FeatureFlagfallback.Rollout
After this PR is deployed, enable the page for everyone by adding this entry to the existing
feature-flagsitem in theglean-developer-feature-flagsEdge Config:{ "claude-code-plugin-v2": { "enabled": true } }For local or preview testing, use:
To force the fallback page:
Validation
pnpm prettier --check .✅pnpm test✅ — 169 passed, 2 skippedpnpm build✅ — fallback page renders when the flag is absentFF_CLAUDE_CODE_PLUGIN_V2=true pnpm build✅ — new page renders with the install flow and optional configuration guidance