v0.7.0

Released: June 1, 2026 · Download

✨ New features

Search flags expansion

idx search gains several new flags for filtering, ranking, and output control:

Flag Description
--any Match any term (shorthand for --operator OR)
--relax N / --relaxation >N Relax AND: require at least N matching terms
--files-only / -l Return only file paths
--count Print only the number of matching files
--hits / --matches-only Show only lines that directly match the query
--time Show query execution time
--skip Skip the first N ranked results
--popularity-weight Boost weight for files frequently read via idx read

Deprecated flag renames (old names still work, emit a warning):

Deprecated Replacement
--agent-compact --compact
--json-pretty --pretty
--size --limit / -n
--from --skip

idx watch removed — watch loop is now internal to idx server

idx watch no longer exists as a separate command. The file-watch loop runs automatically inside idx server run. Starting the server is all that is needed for real-time index sync.

See watch.md for the migration guide.

Read popularity boost

Files accessed via idx read accumulate a read-count that boosts their search ranking. The boost uses 14-day exponential decay and is configurable:

  • Config key: bm25.popularity_weight in .idx.yml (default 0.3)
  • CLI flag: --popularity-weight (set to 0 to disable)

Read log refactoring

.idx/read_log.idx now uses a structured LogEntry format with inode-based rename detection, a 30-day TTL, deletion pruning, and a 5-minute write cache.

🐛 Improvements

idx config show / idx config get

New config inspection commands display the resolved configuration for a project:

idx config show               # full resolved config as YAML
idx config get search.limit   # single value

🏗️ Architecture

  • ADR 0021 — idx watch removed; watch loop is internal to idx server run via WatchWithContext; watch.debounce config key retained.
  • ADR 0017 — Read popularity boost with 14-day exponential decay; weight configurable via bm25.popularity_weight.