Agent skill · software engineering · jeremylongshore
glean-install-auth
Install and configure Glean API authentication with indexing and client
Why this skill is useful
Adds executable scripts for Glean API authentication and SDK setup that aren't in public docs.
What it needs
Requires npm installed locally. Requires glean account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Glean Install & Auth Overview Configure Glean API authentication for enterprise search and knowledge management. Glean has two APIs: the Indexing API (push content into search) and the Client API (search and retrieve). Each uses separate tokens. Base URL: https://<domain>-be.glean.com/api. Prerequisites Glean enterprise account with admin access API token from Glean Admin > API Tokens Your Glean deployment domain (e.g., company-be.glean.com) Instructions Step 1: Obtain API Tokens Navigate to Glean Admin Console > Settings > API: Token Type Purpose Required Header ------------ --------- ---------------- Indexing API token Push documents into search index Authorization: Bearer <token> Client API token Search, chat, user-scoped queries Authorization: Bearer <token> + X-Glean-Auth-Type: BEARER Step 2: Configure Environment Variables Step 3: Install SDK and Verify Error Handling Error Code Cause Solution ------- ------ ------- ---------- Unauthorized 401 Invalid token Regenerate in Admin > API Tokens Forbidden 403 Token lacks scope Use correct token type (indexing vs client) Not Found 404 Wrong domain Verify GLEANDOMAIN includes -be suffix Output Return an authentication setup receipt containing the environment, secret reference (not its value), token scope class, destination allowlist result, synthetic connectivity status, and rotation/cleanup owner. Never print a token or actual request header. Examples env=sandbox; secretref=glean-client-v4; scope=search-only; destination=approved; syntheticprobe=200; rotationowner=platform-ops proves setup without exposing a credential. Resources Glean Developer Portal Indexing API Auth Client API Auth Next Steps After auth, proceed to glean-hello-world for your first index and search.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/glean-install-auth--bebff3