# vscode-git-blame-info

**Repository Path**: unknowIfGuestInDream/vscode-git-blame-info

## Basic Information

- **Project Name**: vscode-git-blame-info
- **Description**: Display git blame information in the editor gutter with color-coded annotations, inspired by Eclipse EGit.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://github.com/tlcsdm/vscode-git-blame-info
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-09
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Git Blame Info

Display git blame information in the editor gutter with color-coded annotations, inspired by Eclipse EGit.

![Demo](readme/demo.gif)

## Features

- **Show Revision Information**: Right-click the editor line number gutter to toggle git blame annotations
- **Color-coded annotations**: Each commit is displayed with a unique background color for easy identification
- **Configurable display**: Choose to show author, date, commit ID, and/or summary in the gutter
- **Hover details**: Hover over annotated lines to see full commit information
- **Open Commit**: Click "Open Commit" in the hover popup to view commit diff details
- **Open History**: Click "Open History" in the hover popup to view the file's commit history
- **Settings**: Click "Settings" in the hover popup to quickly access extension configuration

## Usage

1. Open a file tracked by Git
2. Right-click in the line number gutter area
3. Select **Show Revision Information**
4. Blame annotations will appear next to each line
5. Hover over any line to see detailed commit information

### Hover Popup

When hovering over an annotated line, the popup displays full commit details and provides quick actions:

- **Open Commit** — View the commit's diff in the editor
- **Open History** — View the file's full commit history
- **Settings** — Open extension configuration

## Extension Settings

| Setting | Default | Description |
|---------|---------|-------------|
| `tlcsdm-gitBlameInfo.showAuthor` | `true` | Show author name in gutter |
| `tlcsdm-gitBlameInfo.showDate` | `true` | Show commit date in gutter |
| `tlcsdm-gitBlameInfo.showCommitId` | `false` | Show abbreviated commit ID in gutter |
| `tlcsdm-gitBlameInfo.showSummary` | `true` | Show commit summary in gutter |
| `tlcsdm-gitBlameInfo.useRelativeDate` | `false` | Show relative dates (e.g. "2 months ago") |
| `tlcsdm-gitBlameInfo.dateFormat` | `YYYY-MM-DD` | Date format for gutter annotation |
| `tlcsdm-gitBlameInfo.columnWidth` | `50` | Width of the blame annotation column (20–100 characters) |

## Installation

### From VS Code Marketplace

1. Open VS Code
2. Go to Extensions (`Ctrl+Shift+X`)
3. Search for "Tlcsdm Git Blame Info"
4. Click Install

### From VSIX File

1. Download the `.vsix` file from [Releases](https://github.com/tlcsdm/vscode-git-blame-info/releases)
2. In VS Code, open Command Palette (`Ctrl+Shift+P`)
3. Search for "Extensions: Install from VSIX..."
4. Select the downloaded `.vsix` file

### From Jenkins

Download from [Jenkins](https://jenkins.tlcsdm.com/job/vscode-plugin/job/vscode-git-blame-info/)

## Build

This project uses TypeScript and npm (Node.js 22).

```bash
# Install dependencies
npm install

# Compile
npm run compile

# Watch mode (for development)
npm run watch

# Lint
npm run lint

# Package
npx @vscode/vsce package

# Test
npm run test
```

## Requirements

- Visual Studio Code ^1.85.0
- Git installed and available in PATH

## License

[MIT](LICENSE)