| name | glean-cli |
| description | Glean CLI: access company knowledge, search documents, chat with Glean Assistant, look up people, and manage enterprise content. Use when the user asks about internal docs, company information, people, policies, or enterprise data. |
| compatibility | Requires the glean binary on $PATH. Install via brew install gleanwork/tap/glean-cli |
Glean CLI
The glean command-line tool provides authenticated access to your company's Glean instance. It can search documents, chat with Glean Assistant, look up people and teams, manage collections, and more.
When to Use
Use the Glean CLI when the user:
- Asks about internal documents, policies, wikis, or company knowledge
- Wants to find people, teams, or org structure
- Needs to search across enterprise data sources (Confluence, Jira, Google Drive, Slack, etc.)
- Asks questions that require company-specific context
- Wants to manage Glean resources (collections, shortcuts, pins, announcements)
Installation
brew install gleanwork/tap/glean-cli
Authentication
glean auth login
glean auth status
export GLEAN_API_TOKEN=your-token
export GLEAN_SERVER_URL=<your Glean server URL>
Credentials resolve in this order: environment variables → system keyring → ~/.glean/config.json.
CLI Syntax
glean <command> [subcommand] [flags]
Global Flags
| Flag | Description |
|---|
| --output | json (default), ndjson (one result per line), text |
| --fields | Dot-path field projection (e.g. results.document.title,results.document.url) |
| --json | Complete JSON request body (overrides all other flags) |
| --dry-run | Print request body without sending |
Schema Introspection
Always call glean schema <command> before invoking a command you haven't used before.
glean schema | jq '.commands'
glean schema search | jq '.flags'
Security Rules
- Never output API tokens or secrets directly
- Always use --dry-run before write/delete operations in automated pipelines
- Prefer environment variables over config files for CI/CD
Error Handling
All errors go to stderr; stdout contains only structured output.
Exit code 0 = success, non-zero = error.
Available Commands
| Command | Description |
|---|
| glean activity | Report user activity and feedback. Subcommands: report, feedback. |
| glean agents | Manage and run Glean agents. Subcommands: list, get, schemas, run. |
| glean announcements | Manage Glean announcements. Subcommands: create, update, delete. |
| glean answers | Manage Glean answers. Subcommands: list, get, create, update, delete. |
| glean api | Make a raw authenticated HTTP request to any Glean REST API endpoint. |
| glean chat | Have a conversation with Glean AI. Streams response to stdout. |
| glean collections | Manage Glean collections. Subcommands: create, delete, update, add-items, delete-item. |
| glean documents | Retrieve and summarize Glean documents. Subcommands: get, get-by-facets, get-permissions, summarize. |
| glean entities | List and read Glean entities and people. Subcommands: list, read-people. |
| glean insights | Retrieve Glean usage insights. Subcommands: get. |
| glean messages | Retrieve Glean messages. Subcommands: get. |
| glean pins | Manage Glean pins. Subcommands: list, get, create, update, remove. |
| glean search | Search for content in your Glean instance. Results are JSON. |
| glean shortcuts | Manage Glean shortcuts (go-links). Subcommands: list, get, create, update, delete. |
| glean tools | List and run Glean tools. Subcommands: list, run. |
| glean verification | Manage document verification. Subcommands: list, verify, remind. |
Previously installed per-command skills?
Earlier versions of this project shipped one skill per command (glean-cli-search, glean-cli-pins, etc.). Those are superseded by this consolidated skill. If you still have them installed, remove them with:
npx -y skills remove -g -y \
glean-cli-activity glean-cli-agents glean-cli-announcements \
glean-cli-answers glean-cli-api glean-cli-chat glean-cli-collections \
glean-cli-documents glean-cli-entities glean-cli-insights \
glean-cli-messages glean-cli-pins glean-cli-search glean-cli-shortcuts \
glean-cli-tools glean-cli-verification
