v0.5.0

Released: May 20, 2026 · Download

✨ New features

Read popularity boost for search ranking

idx search now boosts files that have been frequently read via idx read. The boost uses 14-day exponential decay so recently accessed files rank higher without permanently dominating results.

# Control the boost weight at the CLI level
idx search auth token --popularity-weight 0.5

# Disable the boost entirely
idx search auth token --popularity-weight 0

Configurable via .idx.yml:

bm25:
  popularity_weight: 0.3  # default; 0 = disabled
  • ADR 0017: additive log1p-normalised bonus, 14-day exponential decay, configurable weight.

index.ignore replaces index.exclude

The .idx.yml key for excluding paths from indexing is renamed from index.exclude to index.ignore. Update your config file:

# Before
index:
  exclude:
    - vendor/

# After
index:
  ignore:
    - vendor/
    - "*.pb.go"

The composite ignore matcher now evaluates both glob patterns (index.ignore) and .gitignore rules as a unified chain.

🐛 Improvements

SonarCloud integration

CI now reports test coverage to SonarCloud and enforces quality gates per pull request.

SHA-256 cache keys

CI build cache keys now use SHA-256 instead of MD5.

Dynamic git binary resolution

The git binary path is resolved at runtime rather than assumed to be on $PATH. Improves reliability in environments where git is installed in non-standard locations.

GoReleaser configuration

Cross-platform binaries for darwin and linux (amd64 / arm64) are now built and attached to GitHub releases via GoReleaser.

🏗️ Architecture

  • ADR 0017 — read popularity boost in search ranking: additive log1p-normalised bonus with 14-day exponential decay; bm25.popularity_weight in .idx.yml and --popularity-weight CLI flag.
  • Composite ignore matcher unifies glob and gitignore rule evaluation.