Context Lens — semantic codebase index

Context Lens is the first tier of the Token Economy protocol (see core/rules/02-token-economy.md). It's an MCP server that indexes your repo and returns ranked, relevant snippets for natural-language queries.

In repos > 200 files, Lens-first usage cuts ~80% of redundant token usage compared to naive Read cycles.

When to use

• Starting any task in a repo larger than ~200 source files
• Looking for "where is X handled?" before opening files
• Trying to understand a feature that spans multiple modules
• Onboarding to a new codebase

When NOT to use

• Repos < 50 files: Glob + Grep is faster and free
• You already know the exact path: just Read it
• The query is about file names or structure: use Glob