impactlens
v1.1.1
Published
Static code graph scanner and ticket-driven briefing CLI for AI-assisted development. currently only supports php and js/vue
Maintainers
Readme
ImpactLens
⚠️ Before using ImpactLens, read: docs/support.md
It explains what PHP, JavaScript, Vue and Nuxt support actually covers, known limitations, and the maturity of each scanner.
ImpactLens scans a codebase into a queryable graph and maps ticket text to relevant code.
Ticket → Graph → Briefing
It helps you answer:
- Where should I start reading code?
- Which files are relevant to this ticket?
- What breaks if I change this?
- How does a UI action reach backend code?
In summary: ImpactLens helps developers and AI agents find the right place to start, reducing exploration time and improving navigation in large codebases.
Install
npm install impactlensOn install, the agent skill is written to .ai/impactlens/skill.md. Skip with IMPACTLENS_SKIP_SKILL=1. Re-run: npx impactlens install-skill.
npx impactlens --commands
npx impactlens --helpQuick Start
Scan repository
impactlens scan /path/to/repo --lang=both
Analyze ticket
impactlens ticket sqlite/Graph.sqlite
--ticket=tickets/issue.txt
--scopes=php,js
What it builds
- PHP classes, methods, routes
- Vue components
- JS/TS modules
- Imports and calls
- HTTP links (frontend → backend when resolvable)
Main Commands
| Command | Purpose | |----------|----------| | scan | Build graph | | ticket | Ticket → briefing | | ai-context | Analyze one symbol | | change-impact | Blast radius | | architecture | Layer violations | | cycles | Circular dependencies |
Documentation
- docs/support.md ← Read first
- docs/quickstart.md
- docs/config-setup.md
- docs/commands.md
- docs/graph-model.md
- assets/agent-skill/SKILL.md — agent playbook (→
.ai/impactlens/skill.mdon install)
License
ISC
