GitLab Orbit Localを使ってみる
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
- ステータス: ベータ版
GitLab Orbit Localはお使いのマシン上で動作します。orbitバイナリをインストールし、作業スタイルに合ったアクセス方法を選択して、最初のクエリを実行してください。
インストール
orbitバイナリは、ワンラインインストーラーを使って直接インストールするか、npmから、またはすでに使用している場合はGitLab CLI(glab)経由でインストールできます。
Linuxでは、インストーラーはデフォルトでglibcアーカイブを使用し、Alpineなどのmuslベースのディストリビューションでは完全静的なmuslアーカイブを自動的に選択します。静的Linuxアーカイブを強制するには、--libc muslを渡してください。
curl -fsSL "https://gitlab.com/gitlab-org/orbit/knowledge-graph/-/raw/main/install.sh" | bash静的muslバイナリを明示的にインストールする場合(例: glibcシステム上):
curl -fsSL "https://gitlab.com/gitlab-org/orbit/knowledge-graph/-/raw/main/install.sh" | bash -s -- --libc musl新しいターミナルを開いて、確認します:
orbit helpirm https://gitlab.com/gitlab-org/orbit/knowledge-graph/-/raw/main/install.ps1 | iex新しいターミナルを開いて、確認します:
orbit helpエンドポイントポリシーによりリモートスクリプトの実行が制限されている場合は、スクリプトを実行せずにインストールできます。Windowsリリースアーカイブには、GitLab Inc.によって署名された単一の自己完結型orbit.exeが含まれているため、アプリケーション許可リストポリシーで発行者による承認が可能です:
最新リリースから、
orbit-local-windows-x86_64.zipとその.sha256ファイルをダウンロードします。チェックサムを確認します:
(Get-FileHash .\orbit-local-windows-x86_64.zip -Algorithm SHA256).Hash出力は
.sha256ファイルのハッシュと一致する必要があります。比較は大文字・小文字を区別しません:Get-FileHashは大文字を返し、.sha256ファイルは小文字で保存されます。Mark of the Webをクリアします。ブラウザがダウンロード時に付加し、展開時に
orbit.exeに引き継がれるため、初回実行時にSmartScreenのプロンプトが表示されたり、ポリシーによってブロックされたりする場合があります:Unblock-File .\orbit-local-windows-x86_64.zipアーカイブを展開し、ターゲットディレクトリを作成して、
orbit.exeを移動します。この例では、インストーラーが使用するデフォルトと同じ$env:LOCALAPPDATA\Programs\orbitを使用します:Expand-Archive -Path .\orbit-local-windows-x86_64.zip -DestinationPath . New-Item -ItemType Directory -Force -Path "$env:LOCALAPPDATA\Programs\orbit" Move-Item .\orbit.exe "$env:LOCALAPPDATA\Programs\orbit\orbit.exe"そのディレクトリがまだ
PATHに含まれていない場合は、ユーザー用に追加します:[Environment]::SetEnvironmentVariable("PATH", "$env:LOCALAPPDATA\Programs\orbit;$([Environment]::GetEnvironmentVariable('PATH', 'User'))", "User")
管理者権限は不要です。
新しいターミナルを開いて、確認します:
orbit help任意のプラットフォームでnpmからインストールすることもできます:
npm install -g @gitlab/orbit@gitlab/orbitパッケージは、お使いのプラットフォーム向けのビルド済みバイナリをインストールします。Linuxでは、glibcとmuslの両方のディストリビューションで動作する完全静的なmuslバイナリが常に使用されます。
確認します:
orbit helpglabがすでにインストールされている場合:
glab orbit local --install確認します:
glab orbit local help詳細については、glab orbit localリファレンスを参照してください。
アクセス方法を選択する
| 方法 | 最適な用途 | セットアップ |
|---|---|---|
GitLab Orbit CLI(orbit) | CLIの直接使用、スクリプト作成、インデックス作成タスク | ワンラインインストーラーまたはglab orbit local --install |
GitLab CLI(glab) | すでにglabを使用している方 | glab orbit local --install |
| MCP | Claude Code、Codex、その他のAIエージェント | claude mcp add orbit-local -- orbit mcp serve |
3つすべてが同じローカルグラフを参照します。GitLab Orbit LocalはDuckDB SQLでクエリを実行します。構造化JSONクエリDSLはGitLab Orbit Remote専用です。
60秒クイックスタート
glab orbit localは管理されたorbitバイナリをラップします。バイナリは初回使用時にダウンロードされ、チェックサムで検証され、最新の状態に保たれます。glab 1.94以降が必要です。バイナリを直接実行する場合は、orbit CLIを直接使用するを参照してください。
リポジトリのインデックスを作成して、GitLab Orbitが検出した内容を確認します:
glab orbit local index /path/to/your/repo
glab orbit local schemaこれにより、~/.orbit/graph.duckdbにローカルDuckDBグラフが構築され、すべてのテーブルとカラムが表示されます: gl_definition、gl_file、gl_directory、gl_imported_symbol、gl_edge、および_orbit_manifest管理テーブル。
次のステップ:
- 実際のクエリを実行する: glabでGitLab Orbit Localを使用する。
- AIエージェントに接続する:
glab orbit setupを実行してGitLab Orbitスキルをインストールするか、手動設定についてはMCPで接続するを参照してください。 - テーブルレイアウトを確認する: スキーマリファレンス。
課金
GitLab Orbit LocalはGitLabクレジットを消費しません。すべての処理はローカルで行われます。
次に試すこと
- GitLab Orbit Localのインデックス対象 - 対応言語とカバレッジの範囲。
- スキーマリファレンス - ローカルグラフの4つのノードタイプ。
- Cookbook - コピー&ペーストで使えるクエリ集(コードのみのクエリはLocalにも適用可能)。
- GitLab Orbit Remoteを使ってみる - GitLabインスタンス全体をクエリする。