Getting Started

Install

Install LENS globally via npm.

$ npm install -g lens-engine

Quick Start

Initialize, register your repo, and query in seconds.

$ lens init
Config written to ~/.lens/config.json

$ lens repo register .
Registered: my-project (847 files)

$ lens index
Scanning files... 847 files
Building import graph... done
Analyzing git history... done
Index complete in 2.3s

$ lens context "add auth middleware"
Context pack: 12 files, 3.2KB
  src/middleware/auth.ts
  src/routes/login.ts
  src/lib/tokens.ts
  ...

Daemon Mode

Start the HTTP daemon for persistent access on port 4111.

$ lens daemon start
LENS daemon running on http://localhost:4111

$ curl http://localhost:4111/context \
  -H "Content-Type: application/json" \
  -d '{"goal": "add auth middleware"}'

MCP Integration

Claude Code auto-discovers LENS via .mcp.json in your project root. Create the file:

{
  "mcpServers": {
    "lens": {
      "command": "lens-daemon",
      "args": ["--stdio"]
    }
  }
}

Claude Code will spawn the daemon in MCP stdio mode and use it for context lookups automatically. No manual configuration needed.

CLI Reference

All available commands.