I

Code Search Tools

idx: Free Local Code Search for Git Repositories

idx.cool · checked 8 Oct 2026

BM25-powered local code search for Git repositories on Linux and macOS.

How it plugs in

—Public API
NoOpen source
YesFree tier

Signal on Code Search Tools6.0#15 of 42

idx provides free, self-hosted code search within Git repositories. It creates a local index, scores files with BM25 and filename-match boosts, then refreshes that index via a background agent. Searches offer AND or OR modes, path and extension filters, plus a fallback that broadens matching when necessary. Supported AI editor sessions can also receive ranked results.

idx home page

Review

In a line

idx is a local search tool for code stored in Git repositories. It runs on Linux and macOS and returns ranked results for quick queries.

What it does

The tool indexes a codebase and sorts matching files using BM25 relevance scoring, with extra weight for matching filenames. Search supports AND and OR modes, path and extension constraints, and a relaxation fallback when needed.

A background agent watches file changes and synchronizes the index. Files opened with `idx read` gain higher placement in subsequent searches.

During supported Claude Code, Cursor, and GitHub Copilot sessions, the idx skill catches grep and rg requests and responds with concise ranked results.

How it connects

idx operates with Git repositories, so one is required. Its documented AI editor integrations are installed as skills for Claude Code, Cursor, and GitHub Copilot.

The tool runs on your machine with no telemetry, cloud indexing, or data leaving it, according to its maker. It is self-hosted and BSD 3-Clause licensed.

Installation is available through Homebrew on macOS and Linux, with no Go installation or build tools required for that method. Darwin and Linux binaries for amd64 and arm64 are also offered via GitHub Releases.

Good fit

idx suits people who search code in Git repositories and want ranked, local results. Its filters and automatic index updates fit repeated searches across a codebase.

It can also fit AI-assisted coding sessions where Claude Code, Cursor, or GitHub Copilot is used and compact ranked output is useful.

Watch for

A Git repository is required, and the search command needs the background agent to be running. The documented platforms are Linux and macOS.

idx searches codebases but does not provide regex search, code navigation, or IDE extensions. Check whether those missing functions matter to your workflow before choosing it.

Pricing

idx is free. The maker lists a free plan, with no paid plan or separate charge given in the supplied details.

Verdict

Choose idx if you want a local, no-telemetry search index for Git-based code and value ranked matches, file filters, and automatic updates. Its AI editor skill can reduce noisy grep or rg output in supported sessions.

Pass on it if you need regex searches, code navigation, IDE extensions, or a workflow outside Linux and macOS. You must also keep its background agent running for searches and work inside a Git repository.

Our take

idx is a practical option for developers who keep code in Git and want searches confined to their own machine. The free price removes a cost barrier, while BM25 ranking, filename boosts, filters, and read-aware results help narrow large codebases. Its AI editor skill supports a focused workflow in Claude Code, Cursor, and GitHub Copilot. The trade-offs are clear: a Git repository and running background agent are mandatory, and regex search, code navigation, and IDE extensions are not included. Linux and macOS are the listed platforms.

  • Free plan with local, self-hosted operation
  • BM25 and filename ranking for search results
  • AND, OR, path, and extension filters
  • Background agent keeps the index in sync
  • Skills for Claude Code, Cursor, and GitHub Copilot are documented
  • Requires a Git repository
  • Search needs the background agent running
  • Regex search and code navigation are unavailable
  • No IDE extensions listed
  • Runs on Linux and macOS
  • Pick it ifLocal code search in Git repositories; AI editor sessions using supported skills; Users who want no telemetry or cloud indexing
  • Skip it ifYou need regex search, code navigation, or IDE extensions; Your projects are not in Git repositories; You need a platform other than Linux or macOS

Pricing

idx is free under the listed free plan, so buyers do not need to budget for a subscription based on the supplied pricing details.

Questions

What is idx?

idx provides local BM25 search for code in Git repositories, ranking matching files for fast queries.

Which systems run idx?

The listed platforms are Linux and macOS. Binaries are available for Darwin and Linux on amd64 and arm64.

Does idx send code to the cloud?

The maker says idx runs locally with no telemetry, cloud indexing, or data leaving the machine.

What does idx require?

You need a Git repository. Searches also require the idx background agent to be running.

Can idx work with AI coding tools?

The maker documents skill installation for Claude Code, Cursor, and GitHub Copilot. In supported sessions, that skill intercepts grep and rg calls.

Does idx support regular expressions?

No. The supplied details list no regex search, code navigation, or IDE extensions.

How much does idx cost?

idx is free under its listed free plan.