Stacklens

AI-powered code documentation, architecture analysis, and localization generation for Visual Studio Code.

Stacklens helps developers understand, document, localize, and navigate codebases faster by combining intelligent documentation generation, project-level architecture analysis, and AI-assisted localization workflows.

Features

Intelligent Documentation Generation

Generate production-grade documentation directly from source code.

Supported documentation styles:

• JSDoc (JavaScript / TypeScript)
• GoDoc (Go)
• JavaDoc (Java)
• Python Docstrings

Unlike traditional generators, Stacklens analyzes actual implementation details to produce meaningful documentation that reflects real behavior, transformations, validations, and return semantics.

Examples

Generate:

• Function summaries
• Parameter descriptions
• Return descriptions
• Important implementation behavior
• GoDoc comments
• JavaDoc comments
• Python docstrings

Architecture Analysis

Generate AI-powered architecture reports for entire projects.

Stacklens analyzes project structure and relationships to help developers quickly understand unfamiliar codebases.

Architecture Insights

• Project structure
• Module organization
• Service dependencies
• Component relationships
• Layered architecture
• Shared utilities
• Business logic boundaries
• Framework usage
• Entry points and execution flow

Supported Project Types

• TypeScript
• JavaScript
• React
• Next.js
• Node.js
• NestJS
• Express
• Go
• Java
• Python

Localization Generation

Generate translated localization JSON files directly from VS Code.

Stacklens helps developers create localization files such as:

en.json → de.json
en.json → fr.json
en.json → hi.json
en.json → es.json

Instead of manually copying localization content into external AI tools, Stacklens lets you generate translated files from inside your editor.

How It Works

1. Right click on a localization JSON file.
2. Select:

Stacklens: Generate Localization

3. Choose the target language.
4. Stacklens translates the values.
5. The translated JSON file is generated in the same localization folder.

Example:

en.json
↓
de.json

What Stacklens Preserves

Stacklens is designed to keep localization files safe and structured.

It preserves:

• JSON keys
• Nested JSON structure
• Placeholder values like {{name}}, {0}, %s, %d, ${user}
• HTML tags
• URLs
• Variables
• Valid JSON output

Why It Helps

Localization files are not just simple text translation.

The important part is making sure nothing breaks.

Stacklens focuses on:

• Translating only values
• Keeping keys unchanged
• Maintaining the original JSON structure
• Validating generated output
• Preventing broken placeholders
• Reducing manual translation effort

Large File Handling

AI-based localization can consume significant backend resources for very large JSON files.

For large localization files, Stacklens may show a subscription prompt before continuing.

This helps protect backend resources and keeps the free plan stable for all users.

Error Report Support

Stacklens includes a built-in error reporting flow to improve debugging and reliability.

When an error occurs, users can choose to send an error report.

The report may include:

• Error message
• Error stack
• Stacklens extension logs
• VS Code environment details
• Feature context

Reports are generated securely through the Stacklens backend and sent to the maintainer for debugging.

Enterprise-Grade AI Pipeline

Stacklens uses a secure backend architecture.

Benefits:

• No AI provider keys stored in VS Code
• Secure backend proxy
• Provider failover support
• Intelligent local fallback generation
• Centralized request validation
• Rate limiting protection
• Error report handling
• Subscription-aware usage protection

Installation

Visual Studio Marketplace

1. Open VS Code
2. Open Extensions (Ctrl + Shift + X)
3. Search for:

Stacklens

4. Click Install

Usage

Generate Documentation

Generate documentation comments for supported source files.

Steps

1. Open a supported file.
2. Right click on opened file or open Command Palette (Ctrl + Shift + P).
3. Run:

Stacklens: Generate Documentation

4. Stacklens automatically generates documentation comments for functions and methods in the file.

Supported Languages

Generate Architecture Analysis

Generate an architecture report for an entire project.

Steps

1. Open the project root folder in VS Code.
2. Open Command Palette (Ctrl + Shift + P).
3. Run:

Stacklens: Generate Architecture

4. Stacklens scans the project and generates an architecture report.

What Gets Analyzed

• Folder structure
• Source files
• Dependencies
• Services
• Modules
• Shared utilities
• Entry points
• Frameworks
• Internal relationships

Best Results

Run architecture analysis from the root folder of the repository.

Large repositories may require additional processing time.

Generate Localization

Generate translated JSON localization files.

Steps

1. Right click on a localization JSON file such as:

en.json

2. Select:

Stacklens: Generate Localization

3. Choose the target language.
4. Stacklens generates the translated file in the same localization folder.

Example output:

de.json
fr.json
hi.json

Example

Input:

{
  "welcome": "Welcome",
  "logout": "Logout",
  "message": "Hello {{name}}"
}

Generated output for German:

{
  "welcome": "Willkommen",
  "logout": "Abmelden",
  "message": "Hallo {{name}}"
}

The key structure remains unchanged.

View Logs

To view Stacklens logs:

1. Open Command Palette (Ctrl + Shift + P)
2. Run:

Stacklens: Show Logs

Or open:

View → Output → Stacklens

Security

Stacklens follows secure-by-design principles.

Security Features

• No API keys stored in the extension
• Backend-managed AI providers
• Request validation
• Rate limiting
• Secure communication
• Environment-based secret management
• Subscription-aware backend protection
• Secure error report delivery

Performance

Optimized for:

• Large repositories
• Enterprise codebases
• Multi-module projects
• Monorepos
• Modern development workflows
• Structured localization files

AI Providers

Current provider pipeline:

Groq
 ↓
Gemini 2.5 Flash
 ↓
Local Intelligent Fallback

For localization, Stacklens may use provider fallback depending on availability and quota limits.

This ensures better reliability when one provider is temporarily unavailable.

Roadmap

Future planned features:

• Architecture diagrams
• Interactive dependency graphs
• Security analysis
• Refactoring suggestions
• Code explanation
• Project onboarding assistant
• Multi-provider AI routing
• Team knowledge generation
• Improved localization memory
• Changed-key localization updates
• Localization progress tracking

Feedback & Issues

Feature requests, issues, and contributions are welcome.

GitHub:

https://github.com/Ellipse404/Stacklens

License

MIT License

Copyright (c) 2026 Bhaskar Neogi