Orbit Localを使ってみる
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
- ステータス: ベータ版
Orbit Localはお使いのマシン上で動作します。orbitバイナリをインストールし、作業スタイルに合ったアクセス方法を選択して、最初のクエリを実行してください。
インストール
orbitバイナリは、ワンラインインストーラーを使って直接インストールするか、すでに使用している場合は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 helpglabがすでにインストールされている場合:
glab orbit local --install確認します:
glab orbit local help詳細については、glab orbit localリファレンスを参照してください。
アクセス方法を選択する
| 方法 | 最適な用途 | セットアップ |
|---|---|---|
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つすべてが同じローカルグラフを参照します。Orbit LocalはDuckDB SQLでクエリを実行します。構造化JSONクエリDSLはOrbit Remote専用です。
60秒クイックスタート
glab orbit localは管理されたorbitバイナリをラップします。バイナリは初回使用時にダウンロードされ、チェックサムで検証され、最新の状態に保たれます。glab 1.94以降が必要です。バイナリを直接実行する場合は、orbit CLIを直接使用するを参照してください。
リポジトリのインデックスを作成して、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でOrbit Localを使用する。
- AIエージェントに接続する:
glab orbit setupを実行してOrbitスキルをインストールするか、手動設定についてはMCPで接続するを参照してください。 - テーブルレイアウトを確認する: スキーマリファレンス。
課金
Orbit LocalはGitLabクレジットを消費しません。すべての処理はローカルで行われます。
次に試すこと
- Orbit Localのインデックス対象 - 対応言語とカバレッジの範囲。
- スキーマリファレンス - ローカルグラフの4つのノードタイプ。
- Cookbook - コピー&ペーストで使えるクエリ集(コードのみのクエリはLocalにも適用可能)。
- Orbit Remoteを使ってみる - GitLabインスタンス全体をクエリする。