MCPcopy Index your code
hub / github.com/JamiLu/simply-blame

github.com/JamiLu/simply-blame @1.11.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release 1.11.2 ↗ · + Follow
137 symbols 349 edges 32 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

SB - Simply Blame build and test

Idea like git blame annotations for VS Code!

Git blame annotations on the text editor just like in Jet Brains IntelliJ Idea and other familiar code editors. Simply Blame is comprehensively configurable with various settings from date formats, author formats, heat map colors and other settings. Simply Blame is made for VS Code and other VSIX extension compatible code editors.

Steps to use

  1. Install the extension
  2. Press Alt + B on the text editor
  3. You will see who to blame

Key features

  • Fully customizable heat colors use rgb or hex, choose coloring strategy
  • Flexible output options: multiple date formats, author styles
  • Configurable hover box: appearance and action for the commit hash
  • Quick toggle ignore white space via a command Ctrl + Shift + P > SB: Toggle Ignore Whitespace

Install

Screenshots

Dark RGB Colors Light RGB Colors Blame gif

You can choose the hash action from the extension settings that will be invoked when the hash is clicked

Minimal hover annotation

A minimal details box is an alternative to the normal which displays full details. The minimal details box shows only the commit summary

Settings

  • Date Format
  • System will use the locale used by the VS Code.
  • Or you can choose any other pre existing date format to use.
  • Author Style
  • Select an author style for the blame annotations. Supported styles are full name, first name, last name.
  • Hover Style
  • Select a blame annotation hover detail box style. Options are normal and minimal.
  • Hash Action
  • Select an action to be invoked when the commit hash is clicked on the hover box. Supported actions are copy to clipboard and open in browser.
  • Ignore White Space
  • Control global ignore white space from the extension settings.
  • Toggle white ignore white space via quick toggle command (does not affect the global setting).
  • Heat Color Index Strategy
  • Choose how the heat colors are shown. Scale through the commits, this is the default or highlight the latest commits.
  • Keep Blames Open
  • Keep blame annotations open as long as a tab or window is open. If not selected annotations are closed on tab change.
  • Use RGBColor
  • If selected the RGBColors dark and light lists are used. This is the default.
  • Otherwise the hex color list will be used.
  • Heat Map RGBColors List Dark & Heat Map RGBColors List Light
  • Add, edit, choose a color to be used as a heat color.
  • Color must in format rNUM,gNUM,bNUM,cNUM
  • Choose a color by setting it as true. The first matching true will be used or if nothing is matching the first is used.
  • Heat Map Colors Dark & Heat Map Colors Light
  • Configure and change colors of the heat map hex color list.
  • The top is hot and the bottom is cool.
  • Enable Open Blame Editor This setting is likely to be removed in future releases
  • Select to enable a command to open a blame file in a new text editor tab, disabled by default.
  • The enabled command will show up on the context menu of the active text editor tab.

How to find extension settings

How to find settings

Extension points exported contracts — how you extend this code

HoverCreator (Interface)
(no doc) [4 implementers]
src/BlameHoverProvider.ts
BlamedAuthor (Interface)
(no doc)
src/Blame.ts
IndexedHeatMap (Interface)
(no doc)
src/HeatMap.ts
BlamedDate (Interface)
(no doc)
src/Blame.ts
BlamedDocument (Interface)
(no doc)
src/Blame.ts

Core symbols most depended-on inside this repo

restore
called by 26
src/BlameManager.ts
blameFile
called by 13
src/Git.ts
countChange
called by 12
src/HeatMap.ts
emptyBlame
called by 7
src/Blame.ts
createColor
called by 6
src/HeatMap.ts
refresh
called by 6
src/BlameManager.ts
activateExtension
called by 6
src/test/suite/helpers.ts
getLocation
called by 5
src/Utils.ts

Shape

Method 61
Function 47
Class 24
Interface 5

Languages

TypeScript100%

Modules by API surface

src/BlameManager.ts15 symbols
src/BlameHoverProvider.ts14 symbols
src/Settings.ts13 symbols
src/Editor.ts13 symbols
src/HeatMap.ts8 symbols
src/WorkspaceStateHolder.ts7 symbols
src/HeatMapManager.ts7 symbols
src/Blame.ts7 symbols
src/test/suite/helpers.ts6 symbols
src/Logger.ts6 symbols
src/ExtensionManager.ts6 symbols
src/DecorationUtils.ts5 symbols

For agents

$ claude mcp add simply-blame \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact