# Install clangql with Homebrew

Run a SQL like language to perform queries on C/C++ files. Version 0.23.0 via Homebrew; verified 2026-06-15.

## Install

```sh
sudo av install brew:clangql
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install clangql
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:clangql
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/clangql>
- **Version:** 0.23.0
- **Source summary:** Run a SQL like language to perform queries on C/C++ files
- **Homepage:** <https://amrdeveloper.github.io/ClangQL/>
- **Repository:** <https://github.com/AmrDeveloper/ClangQL>
- **Upstream docs:** <https://amrdeveloper.github.io/ClangQL>
- **License:** MIT
- **Source archive:** <https://github.com/AmrDeveloper/ClangQL/archive/refs/tags/0.23.0.tar.gz>
- **Last updated:** 2026-06-15T10:20:12-04:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- clangql (cli)
- clangql (alias)

## Dependencies

- llvm

## Build dependencies

- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.23.0
- Package-manager updated: 2026-06-15
- Local data: ok
- Upstream repository: https://github.com/AmrDeveloper/ClangQL
- Upstream latest detected: 0.23.0 (current)
## Project history and usage

ClangQL is a Rust CLI that applies a SQL-like query language to C and C++ code through Clang AST data and the GitQL SDK.

### Project history

The repository and crates.io package both appeared in April 2024. The README presents ClangQL as a way to query C/C++ code instead of database files, with examples over functions and globals.

The project has had a rapid 0.x release series on crates.io and GitHub tags. Homebrew currently packages a tagged GitHub archive as clangql 0.23.0, while crates.io metadata lists 0.11.0 as the max crate version.

### Adoption history

The README documents both cargo install clangql and brew install clangql. crates.io reported 10,891 total downloads, and Homebrew reported 470 installs over the prior 365 days for the formula.

### How it is used

Users pass source files, a script, or an inline query and can request rendered, JSON, or CSV output. The examples show SQL-like SELECT, COUNT, DISTINCT, LIKE, and matcher predicates over functions and globals.

### Why package nerds care

ClangQL is interesting as a packaging artifact because it combines Rust distribution, libclang availability, and Homebrew bottles for a developer tool whose runtime behavior depends on the local LLVM/Clang stack.

### Timeline

- 2024: GitHub repository and crates.io crate created.
- 2024: Early 0.2.0 and 0.3.0 GitHub releases published.
- 2025: 0.8.0 through 0.11.0 releases published on GitHub/crates.io.
- 2026: Homebrew formula metadata lists 0.23.0 as stable from a GitHub tag.

### Related projects

- GitQL is the query-language SDK named in the README as ClangQL's foundation.
- LLVM/Clang and libclang are required runtime/build dependencies for parsing C and C++ code.

### Sources

- <https://github.com/AmrDeveloper/ClangQL#readme>
- <https://amrdeveloper.github.io/ClangQL>
- <https://api.github.com/repos/AmrDeveloper/ClangQL>
- <https://api.github.com/repos/AmrDeveloper/ClangQL/releases>
- <https://crates.io/api/v1/crates/clangql>
- <https://formulae.brew.sh/api/formula/clangql.json>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** clangql
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [llvm](https://www.automicvault.com/pkg/brew/llvm/) - Runtime dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [clazy](https://www.automicvault.com/pkg/brew/clazy/) - Shares av.db curated category or tags: clang, cli, cpp, developer-tools, static-analysis.
- [include-what-you-use](https://www.automicvault.com/pkg/brew/include-what-you-use/) - Shares av.db curated category or tags: clang, cli, cpp, developer-tools, static-analysis.
- [clang-include-graph](https://www.automicvault.com/pkg/brew/clang-include-graph/) - Shares av.db curated category or tags: clang, cli, cpp, developer-tools.
- [boost-bcp](https://www.automicvault.com/pkg/brew/boost-bcp/) - Shares av.db curated category or tags: cli, cpp, developer-tools.
- [cabin](https://www.automicvault.com/pkg/brew/cabin/) - Shares av.db curated category or tags: cli, cpp, developer-tools.
- [conan](https://www.automicvault.com/pkg/brew/conan/) - Shares av.db curated category or tags: cli, cpp, developer-tools.
- [etl](https://www.automicvault.com/pkg/brew/etl/) - Shares av.db curated category or tags: cli, cpp, developer-tools.
- [metashell](https://www.automicvault.com/pkg/brew/metashell/) - Shares av.db curated category or tags: cli, cpp, developer-tools.
- [clang-uml](https://www.automicvault.com/pkg/brew/clang-uml/) - Local package facts share a topical domain. Shared terms: analysis, clang, cli, code, cpp.

## Combined YAML source

View the package source record on GitHub. [combined/clangql.yml](https://github.com/automic-vault/db/blob/main/combined/clangql.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
