# AmrDeveloper/GQL

GitQL is a extensible SQL-like query language and SDK to perform queries on various data sources such .git files with supports of most of SQL features such as grouping, ordering and aggregation and window functions and allow customization like user-defined types and functions

Repository: https://github.com/AmrDeveloper/GQL
Canonical: https://ross.abutalabs.com/products/gql
Homepage: https://amrdeveloper.github.io/GQL/
Language: Rust
License: MIT
License Family: permissive
Topics: git, gql, sql, engine, interpreter, gitql, rust, database, gitql-sdk, memory-database
Last push: 2026-04-21T18:52:06+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 78, release rhythm 74, longevity 84
- inputs: {"age_days": 1185, "days_push": 134, "days_rel": 177, "gap_med": 24.5, "n_releases_24m": 17}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3512, forks 96 (observed 2026-08-28T04:08:07.735757+00:00)

## What it is
GitQL is a SQL-like query language with an in-memory query engine, implemented in Rust, that executes queries directly on .git files without converting them to a database. It ships as an SDK of libraries so developers can build custom tools to run SQL-like queries over arbitrary data sources, with support for grouping, ordering, aggregation, window functions, and user-defined types and functions.

## Use cases
- query git commit history with SQL
- find most frequent commit authors in a repository
- analyze which files change most often in a git repo
- build a custom SQL query tool for my own data source
- run SQL-like queries on local git files without a database
- list branches and tags with filters and ordering

## When to choose
- you want to analyze local git repositories with familiar SQL syntax
- you need an embeddable in-memory query engine to query custom data sources
- you want extensible query features like user-defined types, functions, and window functions

## When to avoid
- you need a full production SQL database with persistence and transactions
- you need to query remote git hosting APIs rather than local .git files
- you need joins across large external datasets

## Facets
- artifact type: library
- maturity: active
- function: interpreter, parser, database, cli, sdk
- domain: developer-tools, version-control, programming-languages
- platform: rust, cli, cross-platform
- tags: sql-like-query-language, git-analysis, in-memory-query-engine, query-engine, gitql-sdk, command-line

## Member repositories
- AmrDeveloper/GQL (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:07.735757+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:35:39.149709+00:00, confidence not recorded.
  - readme: https://github.com/AmrDeveloper/GQL (fetched 2026-08-28T04:08:07.735757+00:00, sha aa7937cdf0e7)
  - homepage: https://amrdeveloper.github.io/GQL/ (fetched 2026-08-29T09:29:31.030867+00:00, sha 88e847b2bea8)
- Data as of 2026-08-30T08:39:29.467469+00:00.