正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

GitLab CLI（glab）でOrbit Localを使用する

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
  • ステータス: ベータ版
このページには、今後リリース予定の製品や機能に関する情報が記載されています。重要な注意点として、ここで提供される内容は情報提供のみを目的としています。この情報のみに基づいて購入や計画に関する判断を行うことはお控えください。製品や機能の開発、リリース、提供時期は変更または遅延する可能性があり、GitLab Inc.の単独の裁量によって決定されます。

GitLab CLI（glab）は、Orbit Localのインストール、実行、AIエージェントとの統合に推奨される標準的な方法です。glab orbit localはglab orbit remoteと同じ構造を持つため、GitLabインスタンスへのクエリとローカルマシンへのクエリで同じパターンが使用できます。

glab orbit localとglab orbit setupは、glab 1.94以降で現在利用可能です。

トップレベルのコマンドは2つあります。

  • glab orbit local: 管理されたorbitバイナリをラップし、ローカルグラフのインデックス作成とクエリを実行します。
  • glab orbit setup: アクセスの確認、Orbitスキルのインストール、ローカルバイナリのインストールをガイド付きで行うオンボーディングコマンドです。

前提条件

  • glab 1.94以降がインストールされていること。
  • インデックス作成対象のローカルGitリポジトリがあること。

バイナリのインストール後は、glab orbit localの使用にGitLabアカウントやネットワーク接続は不要です。

インストール

管理されたorbitバイナリをインストールします。

glab orbit local --install

glabがバイナリをダウンロードし、チェックサムを検証して、最新の状態に保ちます。 インストールを確認するには、次のコマンドを実行します。

glab orbit local help

AIエージェントをセットアップする

glab orbit setupはガイド付きオンボーディングを実行します。Orbitへの接続確認、AIコーディングエージェントが検出できるようにするOrbitスキルのインストール、ローカルorbitバイナリのインストールを行います。

glab orbit setup
フラグ説明
--yesすべてのプロンプトを承認します（非インタラクティブモード）。
--global現在のリポジトリではなく、ユーザースコープ（~/.agents/skills/）にスキルをインストールします。
--path指定したディレクトリにスキルをインストールします。
--skip-skillスキルのインストール手順をスキップします。
--skip-localローカルバイナリのインストール手順をスキップします。
--upgradeスキルを再取得し、バイナリをその場で更新します。

スキルはorbitバイナリを直接駆動します。MCPクライアントをローカルグラフに接続する場合は、MCPを使用してOrbitにアクセスするを参照してください。

glab skills install --global orbitを使用して、Orbitスキルを手動でインストールすることもできます。

リポジトリのインデックスを作成する

glab orbit local index /path/to/your/repo
フラグ説明
--threadsワーカースレッド数。0（デフォルト）はCPUコア数から自動検出します。
--statsJSON出力に詳細な統計情報を含めます。
--verbosestderrへの詳細ログを有効にします。

グラフに対してSQLを実行する

glab orbit local sql 'SELECT count(*) FROM gl_definition'
echo 'SELECT name FROM gl_definition LIMIT 3' | glab orbit local sql -

スキーマを確認する

glab orbit local schemaは、ローカルDuckDBグラフ内のすべてのテーブルとカラムを一覧表示します。

glab orbit local schema

テーブル名を位置引数として渡すと、出力を絞り込めます。

glab orbit local schema gl_definition              # scoped to one table
glab orbit local schema gl_definition gl_edge      # scoped to two tables
フラグ説明
--rawデフォルトのテーブル表示ではなくJSON形式で出力します。
--dbDuckDBのパスを上書きします。デフォルトは~/.orbit/graph.duckdbです。

MCPサーバーとして実行する

ローカルグラフをMCP対応のAIエージェントに公開します。

glab orbit local mcp serve

MCPプロトコルを通じて~/.orbit/graph.duckdbに対してrun_sql、get_graph_schema、indexを提供します。エージェント統合の詳細については、MCPを使用してOrbitにアクセスするを参照してください。

終了コード

glab orbit localは成功時に0を返し、失敗時にはゼロ以外の終了コードをstderrの詳細とともに返します。スクリプトやエージェントは成功または失敗に応じて処理を分岐できます。

課金

Orbit LocalはGitLabクレジットを消費しません。すべての処理はローカルで行われます。