glean-cli

Glean CLI

glean コマンドラインツールを使うと、認証済みの状態で会社の Glean インスタンスにアクセスできます。ドキュメントの検索、Glean Assistant とのチャット、人物やチームの検索、コレクションの管理などを行えます。

使用する場面

次のような場合は、Glean CLI を使用します。

• 社内ドキュメント、ポリシー、Wiki、会社のナレッジについて質問された場合
• 人物、チーム、組織構造を調べたい場合
• エンタープライズのデータソース（Confluence、Jira、Google Drive、Slack など）を横断して検索する必要がある場合
• 会社固有のコンテキストが必要な質問をされた場合
• Glean リソース（コレクション、ショートカット、ピン、アナウンス）を管理したい場合

インストール

brew install gleanwork/tap/glean-cli

認証

# Browser-based OAuth (interactive — recommended)
glean auth login

# Verify credentials
glean auth status

# CI/scripting (no interactive setup needed)
export GLEAN_API_TOKEN=your-token
export GLEAN_SERVER_URL=<your Glean server URL>

認証情報は次の優先順位で解決されます：環境変数 → システムのキーチェーン → ~/.glean/config.json。

CLI の構文

glean <command> [subcommand] [flags]

グローバルフラグ

フラグ	説明
--output	json（デフォルト）、ndjson（1 行につき 1 つの結果）、text
--fields	ドット区切りのフィールド投影（例：results.document.title,results.document.url）
--json	JSON リクエストボディ全体（ほかのすべてのフラグより優先）
--dry-run	リクエストボディを送信せずに表示

スキーマの確認

使ったことのないコマンドを実行する前に、必ず glean schema <command> を呼び出してください。

glean schema | jq '.commands'          # list all commands
glean schema search | jq '.flags'      # flags for search

セキュリティルール

• API トークンやシークレットを直接出力しないでください。
• 自動化されたパイプラインで書き込み／削除操作を行う前に、必ず --dry-run を使用してください。
• CI/CD では設定ファイルより環境変数を優先してください。

エラー処理

すべてのエラーは stderr に出力され、stdout には構造化された出力のみが含まれます。 終了コード 0 = 成功、0 以外 = エラー。

利用可能なコマンド

コマンド	説明
glean activity	ユーザーのアクティビティとフィードバックを報告します。サブコマンド：report、feedback。
glean agents	Glean エージェントを管理、実行します。サブコマンド：list、get、schemas、run。
glean announcements	Glean のアナウンスを管理します。サブコマンド：create、update、delete。
glean answers	Glean の回答を管理します。サブコマンド：list、get、create、update、delete。
glean api	Glean REST API の任意のエンドポイントに、認証済みの HTTP リクエストをそのまま送信します。
glean chat	Glean AI と会話します。応答は stdout にストリーミングされます。
glean collections	Glean コレクションを管理します。サブコマンド：create、delete、update、add-items、delete-item。
glean documents	Glean ドキュメントを取得して要約します。サブコマンド：get、get-by-facets、get-permissions、summarize。
glean entities	Glean のエンティティと人物を一覧表示、読み取ります。サブコマンド：list、read-people。
glean insights	Glean の利用状況に関するインサイトを取得します。サブコマンド：get。
glean messages	Glean メッセージを取得します。サブコマンド：get。
glean pins	Glean のピンを管理します。サブコマンド：list、get、create、update、remove。
glean search	Glean インスタンス内のコンテンツを検索します。結果は JSON です。
glean shortcuts	Glean のショートカット（go-links）を管理します。サブコマンド：list、get、create、update、delete。
glean tools	Glean のツールを一覧表示、実行します。サブコマンド：list、run。
glean verification	ドキュメントの検証を管理します。サブコマンド：list、verify、remind。

以前にコマンドごとのスキルをインストールしましたか？

このプロジェクトの以前のバージョンでは、コマンドごとに 1 つのスキル（glean-cli-search、glean-cli-pins など）が提供されていました。これらは、統合されたこのスキルに置き換えられています。まだインストールされている場合は、次のコマンドで削除してください。

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