pi-lens

pi-lens gives AI coding agents fast, language-aware feedback while they write/edit.

What It Does

• LSP diagnostics and navigation across supported languages
• Impact cascade diagnostics that show which related files were affected and run LSP diagnostics on them
• Language-specific linters, type-checkers, and scanners on every write/edit
• Safe formatting/autofix where tools are configured or confidently detected
• ast-grep and tree-sitter structural rules for correctness/security smells
• Agent-facing tools for LSP navigation/diagnostics, AST search/replace, diagnostics state, and project intelligence
• Review-graph intelligence for supported languages via bundled tree-sitter WASMs
• Read-guard and edit-autopatch support to reduce bad edits
• Background security/dependency scans for opted-in projects

Install

pi install npm:pi-lens

Or from git:

pi install git:github.com/apmantza/pi-lens

Documentation

• Agent tools — pi tool names, scopes, and arguments
• Usage guide — lifecycle, tool behavior, MCP notes, and troubleshooting
• Features — detailed feature reference
• Tools and commands — runtime flags and slash commands
• Configuration — global and project config files
• Environment variables — common env vars and full reference link
• Language coverage — supported languages, runners, and formatters
• Dependencies — auto-install policy and external tools
• Custom rules — project ast-grep and tree-sitter rules

Contributing

See CONTRIBUTING.md for the development workflow, runner, LSP, formatter, and rule checklists, and issue/PR conventions.

Security issues should be reported privately; see SECURITY.md. pi-lens is released under the MIT License.

Contributors

Thanks goes to these wonderful people:

wastedC 💻 🤔 🚧 👀	Apostolos Mantzaris 💻 📖 🤔 🚧 👀	Dependabot 🚧	silvanshade 💻	Anh Chu 💻	Ruben Paz 💻 🐛	Tifan Dwi Avianto 💻
Ricardo Raposo 💻	C.Junxiang 💻 🐛	Chenxin Yan 💻 📖 🐛	Chris Patti 💻 🐛	Fractiunate // David Rahäuser 💻	Heitor Ramon Ribeiro 💻	JayceFreeman 💻
Max L. 💻	Roman Galeev 💻	Will Mitchell 💻	Amit 💻 🐛	flowing-abyss 💻	jerryfan 💻	minicx 💻
spyrosbazios 💻	Trevon 💻	Carolina 🐛	LeakedBy 🐛	Matthew Booth 🐛	Wiedzmin89 🤔	Virgile 🐛
Finn 🤔	Wayne E 🐛	RimuruW 🤔	Bjynt 🐛 🤔	Tri Van Pham 🐛	BingWuJ 🐛	tackleberrybey 🐛
Mariann Abshire 🐛	ProbabilityEngineer 🤔	Leonardo Rick 🐛 🤔