Schema reference

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
  • Status: Experiment

Orbit Local is experimental. Capabilities and command shape may change before GA.

Orbit Local indexes 4 node types - all in the source code domain. There is no SDLC layer, because Orbit Local does not connect to GitLab.

To inspect the live DuckDB schema at any time:

orbit schema

Source code

Node type Description Key properties
Directory Directory in the indexed repository id, path, name
File Source code file id, path, name, extension, language, content
Definition Function, class, method, or module definition id, file_path, fqn, name, definition_type, start_line, end_line, content
ImportedSymbol Import or cross-file symbol reference id, file_path, import_type, import_path, identifier_name

Relationships

Edges in the local graph connect:

  • Directories to the files and subdirectories they contain
  • Files to the definitions they declare
  • Files to the symbols they import
  • Imported symbols to the definitions they resolve to in other files

Differences from Orbit Remote

Orbit Remote indexes 24 node types across 6 domains. Orbit Local covers only the source code domain. Anything that requires GitLab data - merge requests, pipelines, users, vulnerabilities, work items - is unavailable.

Notes

  • Definition IDs are content-hashed integers scoped per file path. The same function in two indexed repositories will have different IDs.
  • content fields on Definition and File nodes contain the full source text. These are populated so agent tools can hydrate code without separate file reads.
  • There is no authorization layer. Orbit Local does not enforce per-user access control. The graph file at ~/.orbit/graph.duckdb is protected only by file system permissions.