Poly-Glot — AI Code Comments, JSDoc Generator & Code Documentation

The fastest way to generate JSDoc, Javadoc, PyDoc, Doxygen, KDoc, rustdoc, and "why" comments — powered by OpenAI (GPT-4o, o3-mini) or Anthropic (Claude Sonnet 4, Claude Opus 4). 100% client-side. Your API key never leaves your machine.

✨ What is Poly-Glot?

Poly-Glot is a VS Code extension that uses AI to write your code documentation for you — in seconds. Select a function, press a shortcut, and get perfect, language-native comments inserted directly into your file.

• 🗂 JSDoc / TSDoc for JavaScript & TypeScript
• 📖 Javadoc for Java
• 🐍 PyDoc / Google-style docstrings for Python
• ⚙️ Doxygen for C / C++
• 📝 XML doc comments for C#
• 🦀 rustdoc for Rust
• 🐹 GoDoc for Go
• 🐘 PHPDoc for PHP
• 💎 YARD for Ruby
• 🍎 Swift markup for Swift
• 🎯 KDoc for Kotlin
• 🗃 SQL header blocks for SQL

Powered by OpenAI (GPT-4o, GPT-4, o1, o3-mini) and Anthropic (Claude Sonnet 4, Claude Opus 4, Claude Haiku). You bring your own API key — no middleman, no markup, no data collection.

🆓 Free vs 💎 Pro

🎉 Get 3 Months Free — Code EARLYBIRD3

Pro starts at $9/month. Use code EARLYBIRD3 at checkout and get your first 3 months free.

👉 Claim your free months → poly-glot.ai/#pg-pricing-section

After subscribing, open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) → Poly-Glot: Configure License Token to activate Pro instantly.

🚀 Getting Started in 60 Seconds

1. Install Poly-Glot from the VS Code Marketplace
2. Add your API key → Command Palette → Poly-Glot: Configure API Key
   • Choose OpenAI or Anthropic as your provider
   • Pick your preferred model (we recommend gpt-4.1-mini or claude-sonnet-4-5) — or enter any custom model ID
   • Paste your API key (stored securely in the OS keychain — never in settings.json)
3. Select any function or block of code in the editor
4. Press Cmd+Shift+/ (Ctrl+Shift+/ on Windows/Linux) → comments appear inline instantly

That's it. No backend, no account required for the Free tier, no telemetry.

🛠 Features

📝 Generate AI Comments — Cmd+Shift+/ / Ctrl+Shift+/ (Free)

Select code (or leave nothing selected for the whole file) and Poly-Glot writes perfectly formatted, language-native documentation comments and inserts them directly into your file.

What gets generated:

• Function/method summaries in plain English
• @param / @returns / @throws tags (JSDoc, Javadoc, KDoc…)
• Type annotations where applicable
• Edge-case and exception notes
• Language-appropriate formatting — always

No more manually writing boilerplate Javadoc or hunting for the correct JSDoc syntax.

💡 Why-Comments — Cmd+Shift+W / Ctrl+Shift+W (Pro)

AI inserts inline comments that explain why the code exists — not just what it does.

Captures:

• Trade-offs and design decisions
• Non-obvious algorithmic choices
• Performance or security considerations
• Historical context that would otherwise live only in a developer's head

Why-Comments give AI assistants (GitHub Copilot, Cursor, etc.) the context they need to give you better suggestions. They make PRs self-reviewing and onboarding dramatically faster.

🔀 Both Mode — Cmd+Shift+B / Ctrl+Shift+B (Pro)

Generates doc-comments AND why-comments in a single API call. One shortcut, full documentation coverage. Use this on any function you want fully documented before a code review.

🔍 Explain Code — Cmd+Shift+E / Ctrl+Shift+E (Free)

Select any code and open a rich side panel that shows:

📚 Templates Sidebar (Free)

Browse a curated library of comment templates for all 12 supported languages. One-click copy to clipboard for:

• Class/module headers
• Function doc-comment skeletons
• License headers
• TODO / FIXME / HACK / DEPRECATED blocks
• API endpoint documentation stubs

💰 Real-Time Cost Tracking (Free)

Every generation displays the exact token cost in the status bar. A typical function documentation costs < $0.001. Document an entire file for pennies.

⌨️ All Commands & Shortcuts

⚙️ Settings

🤖 Supported AI Models

Poly-Glot accepts any valid model ID from OpenAI or Anthropic — including models not listed here. Just type the model ID into the polyglot.model setting. The extension will use it directly.

OpenAI Models

Get an OpenAI API key at platform.openai.com.

Anthropic Models

Get an Anthropic API key at console.anthropic.com.

* Estimates based on ~200-token input / 400-token output (a typical small function). Costs scale with file size. Check platform.openai.com/pricing and anthropic.com/pricing for current rates.

Using a custom or unlisted model

Set polyglot.model in VS Code settings to any model ID your provider supports:

// settings.json
{
  "polyglot.provider": "openai",
  "polyglot.model": "gpt-4o-2024-11-20"
}

{
  "polyglot.provider": "anthropic",
  "polyglot.model": "claude-3-7-sonnet-20250219"
}

🌍 Supported Languages

🔒 Privacy & Security

Your code and API keys are 100% private:

• 🔑 API keys stored in OS keychain — VS Code SecretStorage (macOS Keychain, Windows Credential Manager, Linux libsecret). Never written to settings.json or any log file.
• 📡 Direct API calls only — requests go from your machine straight to OpenAI or Anthropic. Poly-Glot has no backend server, no relay, no proxy.
• 🚫 Zero telemetry — no usage data, no error reporting, no analytics are ever collected.
• 🏠 Your code never touches our servers — because we don't have any.

OpenAI and Anthropic may use API request data per their own privacy policies. If you're working with sensitive code, check your provider's data-handling settings (both offer zero-data-retention options for API users).

💎 Unlock Pro — 3 Months Free with EARLYBIRD3

If you've tried the Pro features and want to unlock them permanently:

1. Visit poly-glot.ai/#pg-pricing-section
2. Choose a plan and enter code EARLYBIRD3 at checkout
3. Get 3 months completely free
4. Copy your license token from your account dashboard
5. In VS Code: Command Palette → Poly-Glot: Configure License Token → paste token → Pro activates instantly

Pro unlocks:

• ✅ Why-Comments (Cmd+Shift+W)
• ✅ Both Mode (Cmd+Shift+B)
• ✅ All 12 language support (C++, C#, Go, Rust, Ruby, PHP, Swift, Kotlin, SQL)
• ✅ Unlimited file generations per month

❓ FAQ

Do I need a Poly-Glot account? No account is required for the Free tier. Just bring your own OpenAI or Anthropic API key.

Does Poly-Glot work offline? No — it needs to reach the OpenAI or Anthropic API. But no other internet connection is required.

Can I use both OpenAI and Anthropic? You can switch providers any time via Poly-Glot: Configure API Key. Only one provider is active at a time.

Will comments be inserted into my file or shown in a panel? By default, comments are inserted inline at the correct position in your file. Set polyglot.insertInline: false to open a diff panel instead.

What if I select nothing? Poly-Glot documents the entire active file — great for batch documentation.

Is there a team or enterprise plan? Email support@poly-glot.ai for team licensing.

🗺 Roadmap

• [ ] Auto-comment on save
• [ ] Bulk comment entire workspace / folder
• [ ] GitHub Actions integration
• [ ] Custom comment templates editor
• [ ] Team shared templates

Have a feature request? Open an issue on GitHub or email support@poly-glot.ai.

📦 About

Version: 1.3.1
Publisher: poly-glot-ai
Marketplace: poly-glot-ai.poly-glot
Website: poly-glot.ai
License: MIT © Harold Moses

Keywords: AI code comments, JSDoc generator, Javadoc generator, PyDoc generator, Doxygen, KDoc, rustdoc, GoDoc, PHPDoc, YARD, Swift markup, code documentation, why comments, code explainer, OpenAI, Anthropic, Claude, GPT-4, GPT-4o, o3-mini, Claude Sonnet, Claude Opus, AI documentation, automatic comments, VS Code AI, code commenting tool