Git Blame

Optional inline blame.

A simple extension for git blame.

Help

Usage

Extras

Commands

API

package.json

{ "extensionDependencies": ["solomonkinard.git-blame"] }

Get the commit id for the current line.

const id: string | undefined =

  await vscode.commands.executeCommand("gitBlame.getShaForCurrentLine");

console.log(id);

Get the git commit ids whenever a line is focused.

vscode.commands.executeCommand("git-blame.commands.onShaForCurrentLine",

  (ids: string[]) => console.log(ids));

Get the git commit ids whenever a file is focused.

vscode.commands.executeCommand("git-blame.commands.onAllShasForFile",

  (ids: string[]) => console.log(ids));

Get the git commit ids for the file.

// 1-based array where each index is the sha for the line.

const ids: string[] = await vscode.commands.executeCommand(

  "git-blame.api.getAllShasForFile");

console.log(ids);

Get the commits for the file.

vscode.commands.executeCommand(

  "git-blame.commands.onShaListingIndexedByLine",

  (shaForEachLine: string[]) => console.log(shaForEachLine));

Get commits for the commit ids.

const shaToCommitMap: Map<string, Commit> =

  await vscode.commands.executeCommand("git-blame.commands.getAllCommits");

console.log(shaToCommitMap);

Commit type:

interface Commit {

  sha: string;

  date?: string;

  author?: string;

  mail?: string;

  summary?: string;

  previous?: string;

}

FAQ

  1. & VSCE: Git Blame: command 'git-blame.statusClick' not found
  2. & Inquiry about Git Web URL
  1. How to open commits online with multiple repositories and links?
  1. & How to use this extension?
  2. & How is logClickUrls supposed to work?
  3. & Git Blame: Line blame is not aligned properly
  4. & Git blame inline alongside code is not appearing
  5. & Extension source code
  6. & Feature: "Edit web url" should be a VS Code setting
  7. & Feature: "Open commit on the web" should open to the exact line
  8. & Feature: Put all commands in the command palette
  9. & Alignment inline blame causes unaligned blame in case of inlay hints
  10. & The floating box does not appear as expected.
  11. What about changes processed outside of IDE?
  1. There is a setting that does or does not start a new process for blame. If on, changes outside of the IDE should be picked up if the file is in the active editor when it's changed. Feel free to file a bug if and how you think this should be more robust.
  1. Where is the Git Blame menu?
  1. It's only available when a file is open. In order to use the sub-menus the file must reside on disk somewhere. The active file is the seed for many of the available menus. The git directory of that file will be used for some of the listings. That's why an active file needs to be available.

Features

Time Travel 🔮

Back

Context Menu 👩🏾‍🍳

Menu

Blazing Fast ⚡️

Log

Command Center 👨🏽‍🚀

Log

Interactive Diff 📝

Interactive

Inline Blame 🚁

Hover

Git Online 🌎

Web

User Friendly 🐶

Settings

Line History 📜

Diff

Search 👀

Search

Custom Urls 🧤

Click

Right

Tree

Tree menu that allows you to explore an entire repository for a different branch or time, without changing the files in current working directory.

Body

Inline blame hover now includes the commit body.

Setting for hover on all lines or just the active line.

Custom URLs for Open Online

Put a “.gitblame” file in any directory between the file and the repository (inclusive). That allows for more customization, especially when working with multiple repositories at once. For example, the file below would open https://example.com/doc1/$ID, where $ID is the commit id.

.gitblame

{

  "openOnline": {

    "url": "https://example.com/$PROJECT/$ID",

    "replacements": {

      "$PROJECT": "doc1"

    }

  }

}

Bulk Edit

ExperimentalDiff File