LLMBlame

Visualize how LLM prompts and manual edits evolved a file over time.

Features

• Track file evolution over time
• Distinguish between LLM-generated changes and manual edits
• Timeline visualization of file changes

Installation

From VSIX File

1. Download the .vsix file
2. Open VS Code
3. Go to Extensions view (Ctrl+Shift+X / Cmd+Shift+X)
4. Click "..." menu → "Install from VSIX..."
5. Select the downloaded .vsix file

From Marketplace

Search for "LLMBlame" in the VS Code Extensions Marketplace.

Usage

1. Open a file you want to analyze
2. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
3. Run command: "LLMBlame: Show File Evolution"

Publishing Instructions

Prerequisites

1. Install vsce (Visual Studio Code Extension Manager)

   npm install -g @vscode/vsce
   

2. Create a Publisher Account

   • Go to https://marketplace.visualstudio.com/
   • Sign in with Microsoft/GitHub account
   • Click your profile → "Publish Extensions"
   • Create a new publisher ID if you don't have one

3. Generate a Personal Access Token (PAT)

   • Go to https://dev.azure.com/
   • Click "User settings" → "Personal access tokens"
   • Click "New Token"
   • Name: "vscode-marketplace"
   • Organization: "All accessible organizations"
   • Scopes: Select "Marketplace" → "Manage"
   • Click "Create" and copy the token (save it securely!)

Building and Packaging

1. Install dependencies

   npm install
   

2. Build the extension

   npm run build
   

3. Package the extension

   npm run package
   # This creates a .vsix file (e.g., llmblame-0.0.1.vsix)
   

Publishing to Marketplace

1. Login to vsce

   vsce login <your-publisher-name>
   # Enter your PAT when prompted
   

2. Publish the extension

   npm run publish
   # Or specify version bump: vsce publish patch|minor|major
   

3. Verify publication

   • Visit https://marketplace.visualstudio.com/items?itemName=.
   • It may take a few minutes to appear

Publishing Updates

1. Update version in package.json

   # Patch: 0.0.1 → 0.0.2
   vsce publish patch
   
   # Minor: 0.0.1 → 0.1.0
   vsce publish minor
   
   # Major: 0.0.1 → 1.0.0
   vsce publish major
   

Local Installation (Testing)

# Install the packaged extension locally
code --install-extension llmblame-0.0.1.vsix

Important Notes

• Update package.json: Replace repository URL with your actual repository
• Publisher Name: Update the "publisher" field in package.json to match your publisher ID
• Version Management: Follow semantic versioning (MAJOR.MINOR.PATCH)
• Icon: Consider adding an icon.png file (128x128px) and reference it in package.json
• License: Add a LICENSE file to your repository

Development

# Install dependencies
npm install

# Compile TypeScript
npm run build

# Watch mode for development
npm run watch

Requirements

• VS Code ^1.85.0
• Node.js >= 18.0.0

License

MIT

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Support

For issues and feature requests, please visit the GitHub repository.