Inline Blame Mini

Lightweight inline Git blame for VS Code. It shows the author, relative time, and commit summary for the line under your cursor without opening a separate blame view.

Features

• Inline blame for the active cursor line
• End-of-line, above-line, or below-line display modes
• Status bar summary for the active file
• Commit detail panel from the command palette
• Configurable text format, color, font style, font size, margin, and file filters
• Bounded caches, debounced editor events, Git timeouts, and stale-result guards
• Nested Git repository support inside larger VS Code workspaces

Install

Install from the VS Code Marketplace, or build a local VSIX:

bun install
bun run package

Then install the generated .vsix from VS Code with Extensions: Install from VSIX....

Requirements

• VS Code 1.96.0 or newer
• Git available on PATH
• A saved file tracked by Git

Untitled files, ignored files, untracked files, empty lines, very large files, and files outside a Git repository are skipped.

Usage

1. Open a Git-tracked file.
2. Move the cursor to a non-empty line.
3. Inline blame appears using the configured format.

The default format is:

{author}, {timeAgo} • {summary}

Available format tokens:

• {author}
• {timeAgo}
• {summary}
• {hash}
• {prNumber}
• {pr}

Commands

Configuration

{
  "inline-blame-mini.enabled": true,
  "inline-blame-mini.format": "{author}, {timeAgo} • {summary}",
  "inline-blame-mini.summaryMaxLength": 60,
  "inline-blame-mini.showOnlyWhenChanged": true,
  "inline-blame-mini.style.position": "end-of-line",
  "inline-blame-mini.style.color": "rgba(136, 136, 136, 0.7)",
  "inline-blame-mini.statusBar.enabled": true,
  "inline-blame-mini.includeFiles": ["**/*"],
  "inline-blame-mini.excludeFiles": []
}

Display positions:

• end-of-line
• above-line
• below-line

Troubleshooting

You can also run Inline Blame Mini: Show Troubleshooting Guide from the command palette.

Development

bun install
bun test
bun run lint
bun run format:check
bun run test:extension
bun run release:check

The extension smoke test launches a VS Code extension host against a temporary nested Git repository. The generated .vscode-test directory is ignored by linting and packaging.

Packaging

bun run release:check runs tests, lint, formatting checks, packages the VSIX, and installs it through a temporary VS Code profile. After publishing, run bun run verify:marketplace-install before announcing the release. The packaged extension includes only runtime files:

• LICENSE.md
• icon.png
• package.json
• README.md
• src/**

License

MIT