PackagePal 🚀
PackagePal is an AI-powered VS Code extension designed to help developers migrate codebases between languages (e.g., Node.js to Go, Python to Rust, Java to Kotlin) by identifying package dependencies, finding their best equivalents, and highlighting architectural nuances.
Powered by Google Gemini, OpenAI GPT-4o, and Anthropic Claude 3.5, it provides accurate, context-aware suggestions, companion package recommendations, code snippets, and direct links to official documentation.
🎬 Demo
✨ Key Features
1. 🔍 Instant Hover Suggestions
Hover over any import statement in your code (e.g., import axios from 'axios'; or import "fmt") to see instant target language package recommendations:
- Top 3 recommended alternatives.
- 🧩 Companion Package Stacks: Identifies when a target language requires paired crates/libraries (e.g.,
pydantic in Python ➔ serde + validator / garde in Rust).
- ⚠️ Architectural Notes: Highlights technical warnings, async runtime considerations, or data parsing vs. validation differences.
- Code Snippets & Documentation: Instant import and usage snippets with direct links to official documentation.
2. 🧠 Multi-Model AI Support (Pro)
Switch between leading AI models depending on your preference:
- Google Gemini 2.5 Flash (Included in Free & Pro)
- OpenAI GPT-4o & GPT-4o Mini (Pro)
- Anthropic Claude 3.5 Sonnet & Claude 3.5 Haiku (Pro)
Open the PackagePal view in the Activity Bar (Rocket icon) to explore dependencies:
- Active File Mode: Automatically lists packages used in your active file.
- Project-Wide Batch Scanning (Pro): Scans your entire workspace across all 13 supported languages and displays all discovered project packages in the Sidebar.
4. 📄 Token-Optimized Migration Report Export (Pro)
Generate a comprehensive, structured Markdown (.md) migration report for your workspace:
- Summary matrix of all project dependencies ➔ recommended target packages.
- Detailed breakdown with file locations, line numbers, code snippets, and architectural notes.
- Token-Optimized Engine: Built-in offline standard library detector + multi-package batch querying for 60–80% lower API token usage.
⚡ Free vs. Pro Feature Comparison
| Feature |
Free Tier ($0) |
⭐ Pro Tier ($19 one-time) |
| Daily AI Suggestions |
5 / day |
✓ Unlimited |
| Hover Suggestions & Snippets |
✓ Top 3 alternatives |
✓ Top 3 alternatives |
| Companion Packages & Warnings |
✓ Included in hover |
✓ Included in hover & reports |
| Sidebar Explorer |
✓ Active file mode |
✓ Active file & Project-wide mode |
| Supported Languages |
✓ All 13 languages |
✓ All 13 languages |
| Auto-Detect Source Language |
✓ |
✓ |
| AI Models |
Gemini 2.5 Flash |
✓ Gemini + GPT-4o + Claude 3.5 |
| Batch Workspace Scan |
— |
✓ Full project scan |
| Migration Report Export |
— |
✓ Markdown (.md) |
| Device License |
1 device |
✓ Up to 5 devices per key |
| Future Updates |
— |
✓ All future Pro updates included |
🚀 Getting Started
- Install the extension from the VS Code Marketplace.
- Set your API Key:
- Run
PackagePal: Set Gemini API Key (get a free key at Google AI Studio).
- Pro users can also configure
PackagePal Pro: Set OpenAI API Key or PackagePal Pro: Set Anthropic Claude API Key.
- Select Target Language:
- Click the status bar item
$(rocket) Source -> Target (bottom right) or run PackagePal: Set Target Language.
- Start Migrating:
- Open any source file and hover over import statements!
⚙️ Available Commands
| Command |
Category |
Description |
PackagePal: Set Target Language |
PackagePal |
Choose the target language you are migrating to. |
PackagePal: Set Source Language |
PackagePal |
Manually set source language (auto-detected by default). |
PackagePal: Set Gemini API Key |
PackagePal |
Store your Gemini API key in VS Code SecretStorage. |
PackagePal: Scan File for Packages |
PackagePal |
Refresh sidebar for the active file. |
PackagePal: Upgrade to Pro |
PackagePal Pro |
Open Pro upgrade dialog and license activation. |
PackagePal: Buy Pro |
PackagePal Pro |
Open Polar checkout in browser. |
PackagePal: Enter License Key |
PackagePal Pro |
Activate your Pro license key from Polar.sh. |
PackagePal Pro: Select AI Model |
PackagePal Pro |
Choose AI model (Gemini 2.5, GPT-4o, Claude 3.5). |
PackagePal Pro: Set OpenAI API Key |
PackagePal Pro |
Store your OpenAI API key. |
PackagePal Pro: Set Anthropic Claude API Key |
PackagePal Pro |
Store your Anthropic API key. |
PackagePal Pro: Scan Entire Project |
PackagePal Pro |
Scan workspace files and display all project packages in Sidebar. |
PackagePal Pro: Export Migration Report |
PackagePal Pro |
Generate and open a Markdown migration report for the workspace. |
🔒 Privacy & Security
- API Keys: All API keys are stored securely using VS Code's native SecretStorage.
- Code Privacy: Only package import names are sent to AI models to retrieve recommendations. No application logic or proprietary source code is shared.
📝 Release Notes
0.1.0
- PackagePal Pro & Polar.sh Integration: Added freemium licensing, 5/day free usage limit, and Pro license activation.
- Multi-Model AI Support: Added support for OpenAI (
GPT-4o, GPT-4o-mini) and Anthropic Claude (Claude 3.5 Sonnet, Claude 3.5 Haiku).
- 🧩 Companion Package Stacks: AI now identifies multi-crate/package pairs needed for migration (e.g.,
serde + validator).
- ⚠️ Architectural Notes: Highlights structural warnings, data parsing vs. validation gaps, and runtime dependencies.
- ⚡ Token-Optimized Batch Engine: 60-80% token reduction via offline standard library detection & request batching.
- 📄 Workspace Report Exporter: Export workspace-wide migration reports in Markdown (
.md) format.
0.0.4
- Language Dropdowns: Added
TypeScript and JavaScript as selectable options in language pickers.
0.0.3
- Hover Support for 13 Languages: Extended hover provider to Python, Go, Rust, Java, Kotlin, C#, C++, Ruby, PHP, Swift, JS, and TS.
- Sidebar Auto-Refresh: Auto-scans active file on editor switch.
0.0.2
- Multi-Language Detection & MIT License.
0.0.1
Enjoy smoother migrations! 🚀
| |
