GitLab Orbit Local
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
- Status: Beta
GitLab Orbit Local runs entirely on your machine. Build a code graph for any local repository and query its DuckDB tables with read-only SQL. GitLab Orbit Remote uses the Query DSL instead. No GitLab account or network connection is required.
- Indexes: Code in the current working tree, including files, definitions, and cross-file references.
- Storage: DuckDB (local file at
~/.gitlab/orbit/graph.duckdb)
Get started with GitLab Orbit Local
In this section
| Page | Description |
|---|---|
| Get started | Pick an access method and run your first query |
| How it works | Indexing pipeline, graph model, query execution |
| What GitLab Orbit Local indexes | Code coverage, language support, scope |
| Schema reference | The four node types in the local code graph |
Access methods
| Method | Description |
|---|---|
The GitLab Orbit CLI (orbit) | Run the orbit binary directly to index and query |
The GitLab CLI (glab) | Drive GitLab Orbit Local through glab orbit |
| MCP | Expose the local graph to Claude Code, Codex, and other agents |
Billing
GitLab Orbit Local does not consume GitLab Credits. All processing is local.