v1.0 · Open Source · MIT

Persistent developer
context for AI.

ContextLens captures the why behind every change — diffs, AI interactions, decisions — and exposes them to any MCP-compatible client: Claude, Cursor, Gemini, OpenAI Agents.

Install Extension Read Documentation

Free & open source. No account required.

9 MCP Tools
5 Resources
5 Prompts
30-min rotating tokens

Works with major MCP-compatible AI clients and more

Claude Desktop Cursor Antigravity IDE VS Code Agent Gemini CLI OpenAI Agents

See it in action

Run the bridge locally. Inspect its tools. Pipe context into any AI client.

~ contextlens — bash

$ npx @contextlens/cli mcp doctor

✔ Bridge running on 127.0.0.1:3012

✔ 9 tools registered · 5 resources · 5 prompts

✔ Token rotated 12s ago · TTL 30m

… explain_diff over @feat/auth

$ ▍

Click any command below to replay

Engineering capability, not buzzwords

Every primitive is observable, versioned, and inspectable.

Episode Tracking

Group work into logical episodes — features, bugfixes, refactors — with automatic diff and AI capture.

contextlens start

MCP Integration

9 tools, 5 resources, 5 prompts. Drop the bridge into Claude, Cursor, Gemini, OpenAI Agents.

mcp.html#tools

Semantic Search

Find past decisions by meaning, not by filename. Embeddings index every diff and AI exchange.

contextlens search [query]

Git Intelligence

Branch-level PR summaries, change audit trails, AI-generated impact assessments.

contextlens diff

Offline-First

Local episode store. Sync engine reconciles offline state to Firestore when online.

SQLite local cache

Prompt Library

Reusable prompts for code review, security audit, test generation, and diff explanation.

review_code

Timeline Replay

Step through every keystroke, command, and AI call in a single, replayable timeline.

contextlens logs

Secret-Safe

API keys live in OS keychain via VS Code Secrets. Rotating 30-min MCP tokens, local bind only.

Keychain binding

Three layers. One protocol.

Local-first. Cryptographically scoped. Cloud-synced when you want it.

AI Clients

Claude Desktop · Cursor · Gemini CLI · OpenAI Agents · Antigravity · VS Code Agent

MCP Stdio Bridge

JSON-RPC ↔ HTTP. Rotating 30-min tokens. Per-client rate limit. Loopback only.

mcp-bridge.js · stdio

ContextLens Platform

Autonomous watchers · Local episode store · Tool/Resource/Prompt registry · Health checks

VS Code · 127.0.0.1:3012

Cloud Sync Optional

Firebase Functions · Firestore · Vertex AI for embeddings & summaries

The lifecycle of an episode

From start to close, every artifact is captured.

Startbegin
Codeedits
Gitcommits
AIcalls
Snapstore
Reviewaudit
Closearchive

Start Episode

AI client or CLI runs contextlens start. A new tracking session is initialized in your local SQLite database.

< 12msAvg. Local Latency

100%Offline-First (No Cloud Required)

MCP 1.0Protocol Spec

MITOpen Source License

Stop re-explaining your codebase to every AI.

Install the extension. Run the bridge. Connect any MCP client.

Install for VS Code

$ npm i -g
                        @contextlens/cli

Free forever under the MIT license.

Persistent developer context for AI.