idx
idx.cool
- Free plan
- macOS
- Linux
What idx is
idx is a free local search tool for code stored in Git repositories. It ranks files with BM25 scoring and adds a bonus for matching filenames, then returns results through instant queries. Searches can use AND or OR logic, path and file-extension filters, and a relaxation fallback. A background agent watches file changes and keeps the index synchronized; the search command requires that agent to be running. Opening a file with `idx read` gives it a higher rank in later searches. The maker says idx keeps processing on the local machine, with no telemetry, cloud indexing, or data leaving the computer. Skills are documented for Claude Code, Cursor, and GitHub Copilot, including ranked compact results in supported AI-editor sessions. idx runs on Linux and macOS, can be installed through Homebrew without Go, and is BSD 3-Clause licensed. Release binaries target Darwin and Linux on amd64 and arm64.
Who it suits
idx suits developers working in Git repositories who want local, ranked code search. It also fits users of the listed AI editors and those who prefer self-hosted tools.
Good to know, and what to watch
- BM25 ranking includes a filename-match bonus
- Search supports path and extension filters
- Local operation uses no telemetry or cloud indexing
- Read files receive later ranking boosts
- Free BSD 3-Clause software
- Requires a Git repository
- Search requires the background agent
- No regex search or code navigation
- No IDE extensions are listed
The verdict
idx provides focused, local search for Git codebases with ranking and editor-skill support. It is a practical fit when privacy and self-hosting matter, provided the agent and repository requirements work for your workflow.
What the maker publishes
- AI editor integrations
- The maker documents skill installation for Claude Code, Cursor, and GitHub Copilot. source
- AI editor integrations
- The maker documents idx skills for Claude Code, Cursor, and GitHub Copilot. source
- AI workflow
- The idx skill intercepts grep and rg calls in supported AI editor sessions and returns ranked, compact results. source
- Background agent
- A background agent tracks file changes and keeps the index in sync. source
- Background agent
- A background agent tracks file changes and keeps the index in sync during development. source
- Distribution
- The releases page says binaries are available for Darwin and Linux on amd64 and arm64. source
- Installation
- The maker offers installation through Homebrew for macOS and Linux, and says no Go installation is required for that method. source
- Installation
- The maker documents installation via Homebrew and says it works on macOS and Linux without Go. source
- Latest listed release
- The releases page lists v0.10.2, dated July 6, 2026. source
- License
- The maker’s site identifies idx as BSD 3-Clause licensed. source
- License
- The maker lists idx under the BSD 3-Clause License. source
- Offline use
- The maker says idx runs locally with no telemetry, cloud indexing, or data leaving the machine. source
- Prerequisite
- Using idx requires a Git repository; the maker says no build tools are needed. source
- Privacy
- The maker says idx runs locally with no telemetry, cloud indexing, or data leaving the machine. source
- Product
- idx is a local BM25 code search tool for Git repositories, with ranked results and instant queries. source
- Product
- idx is a local BM25 index for searching code in Git repositories, with ranked results and instant queries. source
- Ranking
- Search ranks files with BM25 scoring and a filename match bonus. source
- Ranking
- Search results use BM25 scoring with a filename match bonus. source
- Read-aware ranking
- Files opened with `idx read` receive a ranking boost in later searches. source
- Read-aware results
- Files opened with `idx read` receive a ranking boost in future searches. source
- Release downloads
- The maker says binaries for darwin and linux on amd64 and arm64 are available on GitHub Releases. source
- Requirement
- Using idx requires a Git repository. source
- Search filters
- Queries support AND and OR modes, path and file extension filters, and relaxation fallback. source
- Search filters
- Search supports path and file extension filters, AND and OR queries, and relaxation fallback. source
Checked against the maker's pages on 8 Oct 2026.