# Install fileql with Homebrew, winget Run SQL-like query on local files instead of database files using the GitQL SDK. Version 0.10.0 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:fileql ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install fileql ``` Evidence: local Homebrew formula metadata ### Windows - winget (92%): ```sh winget install --id amrdeveloper.fileql -e ``` Evidence: Windows Package Manager source index: amrdeveloper.fileql from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:fileql - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.10.0 - **Source summary:** Run SQL-like query on local files instead of database files using the GitQL SDK - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - fileql (cli) - fileql (alias) ## Build dependencies - rust ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.10.0 - Local data: ok - Upstream repository: https://github.com/AmrDeveloper/FileQL - Upstream latest detected: 0.10.0 (current) - info: No package-manager update timestamp was available. ## Project history and usage FileQL is a small Rust CLI that runs SQL-like queries against local filesystem metadata instead of a database, using the GitQL SDK. Its package-manager hook is simple: it gives developers a query-language way to inspect files from a shell pipeline or terminal without standing up a database. ### Project history The FileQL repository was created in February 2024. The README describes it as File Query Language and says it lets users run SQL-like queries on local files using the GitQL SDK. The first tagged release, 0.1.0, was published in February 2024, followed by a short sequence of 0.x releases through 2025. The README documents a `files` table with columns such as path, parent, extension, is_dir, is_file, and size, plus SQL-like examples such as SELECT, COUNT, DISTINCT, LIKE, and local-file query functions. ### Adoption history FileQL is a newer niche developer tool rather than a broad infrastructure standard. Its adoption evidence is mainly official packaging/install notes from the README, which point to Cargo and winget, plus source_facts package-manager data for Homebrew and winget. The project is best understood as part of the GitQL family of experiments: applying a familiar SQL-ish query model to developer-local data sources that are normally handled with find, awk, ls, or custom scripts. ### How it is used Users run FileQL with paths supplied via file-selection options and a query supplied on the command line, optionally enabling pagination or choosing render, JSON, or CSV output. Useful queries include enumerating files, grouping by parent directory, counting children, filtering by extensions, and emitting machine-readable output for further scripting. Because FileQL is read-oriented and local, its workflow is lightweight: install the CLI, point it at paths, and use SQL-style expressions where shell globbing or ad hoc parsing gets awkward. ### Why package nerds care FileQL is notable less for scale than for shape: it is a Rust CLI distributed through developer package channels, with no daemon, no config, and no credentials. It is also a tidy example of a domain-specific query executable where the package name, binary, README examples, and install path are the whole product surface. ### Timeline - 2024-02: Repository created and 0.1.0 release published. - 2024-03: 0.2.0 release published. - 2024-08: 0.6.0 and 0.7.0 releases published. - 2024-11: 0.9.0 release published. - 2025-02: 0.10.0 release published. ### Related projects - FileQL is built around the GitQL SDK and belongs to the broader family of SQL-like command-line query tools for developer data. - Adjacent tools include GitQL itself, filesystem search tools, and JSON/CSV-producing command-line utilities. ### Sources - - - - ## 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:** fileql - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - winget - amrdeveloper.fileql: normalized package name match | Windows Package Manager source index: amrdeveloper.fileql from https://cdn.winget.microsoft.com/cache/source.msix ## 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. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [sqlx-cli](https://www.automicvault.com/pkg/brew/sqlx-cli/) - Shares av.db curated category or tags: cli, developer-tools, sql. - [clangql](https://www.automicvault.com/pkg/brew/clangql/) - Shares av.db curated category or tags: cli, developer-tools, sql. - [dasel](https://www.automicvault.com/pkg/brew/dasel/) - Shares av.db curated category or tags: cli, developer-tools, query-tool. - [dbmate](https://www.automicvault.com/pkg/brew/dbmate/) - Shares av.db curated category or tags: cli, developer-tools, sql. - [dbml-cli](https://www.automicvault.com/pkg/brew/dbml-cli/) - Shares av.db curated category or tags: cli, developer-tools, sql. - [flyway](https://www.automicvault.com/pkg/brew/flyway/) - Shares av.db curated category or tags: cli, developer-tools, sql. - [harlequin](https://www.automicvault.com/pkg/brew/harlequin/) - Shares av.db curated category or tags: cli, developer-tools, sql. - [jet](https://www.automicvault.com/pkg/brew/jet/) - Shares av.db curated category or tags: cli, developer-tools, sql. - [jsawk](https://www.automicvault.com/pkg/brew/jsawk/) - Local package facts share a topical domain. Shared terms: cli, data, developer, developer-tools, like. ## Combined YAML source View the package source record on GitHub. [combined/fileql.yml](https://github.com/automic-vault/db/blob/main/combined/fileql.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 - external package-manager database matches - cross-ecosystem install command graph