v0.2.0

Released: May 12, 2026 · Download

✨ New features

Inspect TUI

Interactive terminal interface for browsing the index. Navigate directories and files, inspect BM25 payloads, and view raw index content without leaving the terminal.

idx inspect .
idx inspect internal/core

Boolean AND / OR operators with relaxation

Search queries now support explicit boolean logic. AND mode falls back gracefully when results are sparse — instead of returning empty, idx progressively removes trailing terms until results are found.

# strict AND
idx search "func auth token validate" --operator AND

# AND with relaxation: falls back if fewer than 2 results
idx search "func auth token validate" --operator AND --relaxation '>2'

# OR: any term matches
idx search auth token --operator OR

Extension filter (--ext)

Scope any search to a specific file type.

idx search "rate limit" --ext go
idx search "handler" --ext ts

--agent-compact flag

Optimized output format for AI agent workflows — reduces token usage while preserving all result data.

--quiet global flag

Suppresses informational output across all commands. Errors are still written to stderr.

idx sync --quiet
idx daemon enable . --quiet

Version command

idx version (and idx --version) now outputs structured build metadata injected at compile time.

🐛 Improvements

  • Enhanced filename tokenization — CamelCase and snake_case are split before BM25 scoring, improving recall for symbol names
  • More robust daemon startup with idempotent process management
  • Refined AND relaxation logic with controlled fallback behavior

📦 Dependencies

  • Bump fsnotify 1.9.0 → 1.10.1
  • Bump go.uber.org/zap 1.27.0 → 1.28.0
  • Bump bubbletea 1.3.4 → 1.3.10

🏗️ Architecture

  • ADR 0008 — boolean AND / OR operator with term-coverage multiplier
  • ADR 0009 — filename partial-match bonus for relevance ranking
  • ADR 0010 — filename tokens indexed in BM25 corpus for recall
  • ADR 0012 — --ext metadata filter