![\"LensPR\"](\"assets/LensPR.png\")
\n\n \n
Code intelligence for AI coding agents. Your AI sees dependencies before making changes.
\n\n> Alpha (0.1.x) — works on real projects, used daily by the author. Expect rough edges.\n\nAI assistants edit your code one file at a time. They don't see dependencies. They grep, read, guess — and break things three files away.\n\nLensPR builds a dependency graph of your codebase and gives your AI structural understanding before it changes anything.\n\n\n\n\n## Quick Start\n\nRequires **Python 3.11+**, **macOS or Linux**. For TypeScript/JS projects, also **Node.js 18+**.\n\n```bash\npip install 'lenspr[all]'\nlenspr init .\nlenspr setup .\n```\n\nRestart your IDE. Done. Your AI now has `lens_*` tools.\n\n> Add `.lens/` to your `.gitignore` — the graph is local and rebuilt from source.\n\n---\n\n## What It Does\n\n### \"What depends on this function?\"\n\nOne call returns source code, who calls it, what it calls, and related tests:\n\n```\n> lens_context(\"auth.login_handler\")\n\nsource: 42 lines\ncallers: auth_routes.create_routes, test_auth.test_login_success\ncallees: db.get_user, crypto.verify_password, jwt.create_token\ntests: test_login_success, test_login_wrong_password\n```\n\nWithout LensPR your AI makes 5-7 grep/read calls and still misses things. With LensPR — one call, full picture.\n\n### \"What breaks if I change this?\"\n\nBefore any modification, the AI sees the blast radius:\n\n```\n> lens_check_impact(\"models.User\")\n\nseverity: CRITICAL\ndirect_dependents: 15\nindirect_dependents: 23\naffected_modules: auth, payments, notifications\ntests_covering: 3\n```\n\nThe AI warns you, changes its approach, or asks for confirmation. No more blind edits.\n\n### \"How healthy is this codebase?\"\n\n```\n> lens_vibecheck()\n\nscore: 86/100 (B)\n test_coverage: 17/25 — 67% functions tested\n dead_code: 20/20 — 0% dead code\n circular_imports: 15/15 — 0 cycles\n architecture: 12/15 — 1 violation\n documentation: 8/10 — 81% documented\n graph_confidence: 14/15 — 94% edges resolved\n```\n\nTrack whether the codebase is improving or degrading over time.\n\n### Cross-language visibility\n\nLensPR connects frontend and backend into a single graph:\n\n```\nLoginModal.tsx → fetch(\"/api/auth/login\")\n ↓ CALLS_API\nBackend: @router.post(\"/login\") → login_handler()\n → db.query(User) [reads: users]\n → verify_password()\n → create_jwt_token()\n```\n\nAlso tracks: database tables, Docker services, env vars, CI/CD workflows, SQL migrations.\n\n---\n\n## Works With\n\n| IDE | Setup |\n|-----|-------|\n| **Claude Code** | `lenspr setup .` — automatic |\n| **Cursor** | Copy `.mcp.json` to `.cursor/mcp.json` |\n| **Any MCP client** | `lenspr serve