Skip to content

Glean Search

Glean Search

MIT CI TypeScript Vitest

Search your company's knowledge base via Glean directly from Raycast.


What It Does

Start typing in Raycast, get results from your company's Glean-connected apps — Slack, Jira, Confluence, Google Workspace, GitHub, and more. Open a result or copy its URL, all from your keyboard.

Feature Description
Search across 100+ connectors Query indexed content from all your team's tools in one place
Instant results Results appear as you type with title, datasource, and snippet preview
Open in browser Press Enter to open any result in your default browser
Copy URL Press Cmd+C to copy a result URL to the clipboard
Zero configuration The Glean CLI is auto-downloaded and verified on first launch
OAuth authentication Sign in via your browser with email-based instance discovery

How It Works

flowchart TB
    subgraph User["You"]
        A["Open Raycast<br/>type query"]
        B["Press Enter<br/>or Cmd+C"]
    end

    subgraph Extension["Glean Search Extension"]
        C["search-glean.tsx<br/>React UI"]
        D["useGlean hook<br/>orchestrator"]
        E["glean CLI<br/>auto-downloaded"]
    end

    subgraph External["External"]
        F["Glean Cloud API<br/>(your company)"]
        G["GitHub Releases<br/>SHA-256 verified"]
    end

    A --> C
    C --> D
    D --> E
    E --> F
    E -.->|"first launch"| G
    C --> B

Authentication

flowchart LR
    START["Open Search Glean"] --> CHECK{"Signed in?"}
    CHECK -->|"Yes"| SEARCH["Search your knowledge base"]
    CHECK -->|"No"| PROVIDE{"Server URL<br/>known?"}
    PROVIDE -->|"Yes (cached)"| OAUTH["Browser-based OAuth"]
    PROVIDE -->|"No (first time)"| EMAIL["Enter work email"]
    EMAIL --> LOOKUP["Instance lookup"]
    LOOKUP --> SAVE["URL cached in<br/>~/.glean/config.json"]
    SAVE --> OAUTH
    OAUTH --> SEARCH

Key capabilities

  • Auto-downloads glean CLI

    The binary is downloaded from GitHub Releases, verified via SHA-256, and cached. No manual installation.

  • Email-based instance discovery

    Enter your work email once to look up your Glean instance. The server URL is cached in ~/.glean/config.json for subsequent use.

  • No preferences to configure

    gleanHost and gleanCliPath preferences have been removed. The extension discovers everything automatically.

  • CLI delegation

    All search and auth is handled by the official glean CLI. The extension wraps it in a Raycast-native UI.

  • 24 test suite

    Vitest tests for auth, CLI discovery, and sign-in flows ensure reliability.

Quick start

git clone https://github.com/faizhasim/glean-search.git
cd glean-search
npm install && npm run build

Then open Search Glean in Raycast. Sign in with your work email, and you're ready to search.

Note: The extension is pending Raycast Store approval. Until then, install from source using the instructions above.

Not affiliated with Glean. Glean is a trademark of Glean Technologies, Inc.