# 使用 Homebrew, winget 安装 fileql

查看 fileql 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:fileql
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install fileql
```

  证据: local Homebrew formula metadata

### Windows

- winget (92%):

```sh
winget install --id amrdeveloper.fileql -e
```

  证据: Windows Package Manager source index: amrdeveloper.fileql from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:fileql
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/fileql>
- **版本:** 0.10.0
- **来源摘要:** Run SQL-like query on local files instead of database files using the GitQL SDK
- **主页:** <https://github.com/AmrDeveloper/FileQL>
- **仓库:** <https://github.com/AmrDeveloper/FileQL>
- **上游文档:** <https://github.com/AmrDeveloper/FileQL#readme>
- **许可证:** MIT
- **源码归档:** <https://github.com/AmrDeveloper/FileQL/archive/refs/tags/0.10.0.tar.gz>
- **已生成:** 2026-07-08T18:08:21+00:00

## 可执行文件

- fileql (cli)
- fileql (别名)

## 构建依赖

- rust

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 0.10.0
- 本地数据: OK
- 上游仓库: https://github.com/AmrDeveloper/FileQL
- 检测到的最新版本: 0.10.0 (当前)
- 信息: No package-manager update timestamp was available.
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://github.com/AmrDeveloper/FileQL>
- <https://github.com/AmrDeveloper/FileQL/releases/tag/0.1.0>
- <https://github.com/AmrDeveloper/FileQL/releases/tag/0.10.0>
- <https://raw.githubusercontent.com/AmrDeveloper/FileQL/master/README.md>


## 安全说明

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

- **Geiger 风险:** blue / 中
- broad file, network, media, or database tool signal

## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** fileql
- **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

## 其他软件包管理器记录

- winget - amrdeveloper.fileql: normalized package name match | Windows Package Manager source index: amrdeveloper.fileql from https://cdn.winget.microsoft.com/cache/source.msix


## 相关链接

- [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/zh-hans/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/zh-hans/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [rust](https://www.automicvault.com/zh-hans/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [sqlx-cli](https://www.automicvault.com/zh-hans/pkg/brew/sqlx-cli/) - Shares av.db curated category or tags: cli, developer-tools, sql.
- [clangql](https://www.automicvault.com/zh-hans/pkg/brew/clangql/) - Shares av.db curated category or tags: cli, developer-tools, sql.
- [dasel](https://www.automicvault.com/zh-hans/pkg/brew/dasel/) - Shares av.db curated category or tags: cli, developer-tools, query-tool.
- [dbmate](https://www.automicvault.com/zh-hans/pkg/brew/dbmate/) - Shares av.db curated category or tags: cli, developer-tools, sql.
- [dbml-cli](https://www.automicvault.com/zh-hans/pkg/brew/dbml-cli/) - Shares av.db curated category or tags: cli, developer-tools, sql.
- [flyway](https://www.automicvault.com/zh-hans/pkg/brew/flyway/) - Shares av.db curated category or tags: cli, developer-tools, sql.
- [harlequin](https://www.automicvault.com/zh-hans/pkg/brew/harlequin/) - Shares av.db curated category or tags: cli, developer-tools, sql.
- [jet](https://www.automicvault.com/zh-hans/pkg/brew/jet/) - Shares av.db curated category or tags: cli, developer-tools, sql.
- [jsawk](https://www.automicvault.com/zh-hans/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)


## 来源

- 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
