AlchemyLab VSCode Extension

A seamless VSCode integration for AlchemyLab that enables you to view file diffs directly in your editor. Click any diff link from Alchemy-UI and instantly see the changes in VSCode's powerful diff viewer.

✨ Features

• One-click diff viewing - Click diff links in Alchemy-UI to open them directly in VSCode
• Git integration - Uses VSCode's built-in Git support for accurate diff rendering
• Seamless workflow - No context switching between tools
• URI handler - Automatically handles vscode://testfiresoftware.alchemylab/show-diff URLs

🚀 Quick Start

1. Install the extension from the VSCode marketplace
2. Open your Git repository in VSCode
3. Click any diff link in Alchemy-UI - it will automatically open in VSCode!

📋 Requirements

• VSCode 1.80.0 or higher
• A Git repository opened in VSCode
• AlchemyLab or Alchemy-UI generating diff links

🔧 Usage

From Alchemy-UI

Simply click any commit hash or diff button in Alchemy-UI. The extension automatically:

1. Receives the diff URL
2. Parses the file path and commit information
3. Opens VSCode's diff viewer with the requested comparison

Manual Testing

You can also test the extension manually using the Command Palette:

1. Open Command Palette (Cmd+Shift+P or Ctrl+Shift+P)
2. Run: AlchemyLab: Test AlchemyLab Connection
3. Should display: "AlchemyLab extension is working!"

URL Format

The extension handles URLs in this format:

vscode://testfiresoftware.alchemylab/show-diff?file=path/to/file.js&commit=abc123&previous=def456

🛠️ Development

Setup

1. Clone this repository
2. Open in VSCode
3. Press F5 to launch Extension Development Host
4. Test in the new VSCode window

Testing with URI

# macOS
open "vscode://testfiresoftware.alchemylab/show-diff?file=README.md&commit=HEAD"

# Windows
start "vscode://testfiresoftware.alchemylab/show-diff?file=README.md&commit=HEAD"

# Linux
xdg-open "vscode://testfiresoftware.alchemylab/show-diff?file=README.md&commit=HEAD"

📝 License

MIT License - see LICENSE file for details.

🐛 Issues & Support

Found a bug or have a feature request? Please open an issue on GitHub.

📦 Installation

From Marketplace

Search for "AlchemyLab" in the VSCode Extensions marketplace and click Install.

Manual Installation

1. Download the latest .vsix file from releases
2. In VSCode: Extensions > Install from VSIX...
3. Select the downloaded file

Made with ⚗️ by TestfireSoftware