Intelligent import management for VS Code and CI/CD pipelines — detect, remove, and organize unused imports with AST-level precision across six languages.

Supported Languages

| Language | Detection | Organize Imports | |---|---|---| | TypeScript / JavaScript | Babel AST | Yes | | Python | Tree-sitter / regex | Yes — PEP 8 groups | | Java | Tree-sitter / regex | Yes — package groups | | Go | Tree-sitter / regex | Yes — stdlib / third-party | | Rust | Tree-sitter / regex | — | | C / C++ | Heuristic | — | | 50+ others | LSP | — |

Installation

VS Code — Extensions panel → search ImportLens → Install

CLI

npm install -g importlens

Enable Tree-sitter (optional, recommended for Python/Java/Go/Rust)

npm install --save-optional tree-sitter tree-sitter-python tree-sitter-java tree-sitter-go tree-sitter-rust

VS Code Commands

Open the Command Palette (Ctrl+Shift+P) and type ImportLens:

• Clean Current File — remove unused imports from the active editor
• Clean Workspace — remove unused imports across all open files
• Organize Imports — sort and group imports by language convention
• Show Team Dashboard — workspace health metrics with git contributor data
• Show Import Statistics — historical trend charts
• Toggle Safe Mode — preserve or allow removal of side-effect imports

CLI

# Detect unused imports
importlens-cli --check src/

# Auto-fix (safe mode preserves side-effect imports)
importlens-cli --fix --safe-mode src/

# CI/CD — annotate GitHub Actions with inline warnings
importlens-cli --check --format=github src/

# Baseline workflow — track debt without blocking the pipeline
importlens-cli --baseline-generate src/
importlens-cli --baseline-check src/

# Team analytics report
importlens-cli --analytics --analytics-output=report.json src/

Output formats: text · json · github · junit

The CLI automatically distributes work across CPU cores using worker threads for faster analysis in large monorepos.

CI/CD

- name: ImportLens — check unused imports
  run: |
    npm install -g importlens
    importlens-cli --check --format=github src/

Configuration

{
  "importlens.safeMode": true,
  "importlens.enableOnSave": false,
  "importlens.excludePatterns": ["**/node_modules/**", "**/dist/**"]
}

Documentation

User Guide · Architecture · Changelog · Contributing

MIT License · GitHub · NPM · VS Code Marketplace