jhspetersson/fselect

Find files with SQL-like queries

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 1 hour ago
Type:CLI ToolCategory(s):CLI UtilitiesDeveloper Tools
Added to GitGenius on September 15th, 2026
Created on January 26th, 2018
Open Issues & Pull Requests: 6 (+0)
GitHub issues: Enabled
Number of forks: 87
Total Stargazers: 4,467 (+0)
Total Subscribers: 37 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 18.0 hours
Mean response time: 149.9 days
90th percentile: 263.0 days
Tracked items: 33

Most active contributors

Sign in to see contributor activity.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 2
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 589 days
Stale 30+ days: 1
Stale 90+ days: 1

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

No label distribution available yet.

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

fselect is a command-line tool that finds files using SQL-like query syntax instead of traditional find commands.

The tool addresses the limitations of conventional file search utilities by translating SQL-like queries into filesystem operations. Rather than memorizing complex flag combinations for find or ls, users write relaxed SQL grammar that reads naturally. The approach supports subqueries to compare results across directories, aggregate functions, and statistical operations. Beyond basic file matching, fselect can search within archives, respect ignore files like .gitignore and .dockerignore, and query specialized file metadata including image dimensions and EXIF data, audio tags across multiple formats, extended file attributes, POSIX ACLs, and file hashes. It also supports MIME type filtering and shortcuts for common file categories.

Developers should choose this tool if they frequently construct complex file searches or need to query file metadata that standard utilities expose poorly. It suits projects where filesystem queries are part of automation or analysis workflows, particularly when those queries involve multiple conditions or metadata inspection. The tool includes an interactive mode for exploratory searches and can leverage system indexes through plocate on Linux or Everything on Windows for dramatically faster results on large filesystems. Output can be formatted as CSV, JSON, or other formats for integration with downstream tools.

The project maintains active development with regular feature additions and bug fixes. The tool is distributed across multiple package managers and platforms, with precompiled binaries available for Linux, Windows, and macOS, plus installation support through Debian, Fedora, Arch, NixOS, Chocolatey, Scoop, and winget. The codebase is written in Rust and can be built from source with optional feature flags for index-backed search support.