pi-lens

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	Ken Banks	Rico Sta. Cruz	Nikita Bilous	Andrea Arturo Venti Fuentes
dacec354	Xu Yili	Brandon Martin	Alper Tarhan	Andrius Solopovas	Graham Jenkins	Wings Butterfly
Johannes Klauss	Tan Yong Sheng	Frédéric	Salvador Fuentes Jr	Viktor	Gregory Orton	Jim Allen
quantfiction	Art	Colin Swenson-Healey	Laurent Wiesel	Rei Starks	Roberto Freitas

If you land a pull request or report an issue that gets fixed, we'll add you here.