Lightweight, zero-network local Git code trace extension for VS Code.
CodeTrace is a performant, privacy-first Git blame extension that works entirely offline. It provides inline blame annotations, hover commit details, and sidebar history panels — all without sending any data externally.
Features
Inline Blame — Author, relative time, and commit summary displayed inline at the end of the current line. Automatically refreshes as you move the cursor.
Hover Details — Hover over any line to see the full commit metadata: author, timestamp, commit message, and short hash.
Uncommitted Changes — Lines with uncommitted modifications are clearly labeled as "Uncommitted Changes".
Line History Panel — Sidebar panel tracking the full commit chain that modified the currently selected line, using git log -L.
File History Panel — Sidebar panel showing the complete commit timeline for the currently open file.
Status Bar — Displays current branch and commit hash of the selected line. Click to open the sidebar.
Plugin Conflict Detection — Automatically on startup (and on-demand via command) detects GitLens, Git Graph, Git History, and Git Blame extensions, offering one-click disable of their conflicting features.
Multi-language — Full English and Chinese (简体中文) support. Auto-detects VS Code display language.
Theme Adaptive — All UI elements follow VS Code's native theme colors. No custom color schemes.
100% Local — No network requests. No telemetry. No data collection. Your code never leaves your machine.
Requirements
VS Code ≥ 1.75.0
Git ≥ 2.20.0
Installation
From VS Code Marketplace
Open VS Code
Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
Search for Git Code Trace
Click Install
From VSIX
code --install-extension codetrace-1.0.0.vsix
Commands
Once installed, CodeTrace activates automatically when you open a workspace containing a .git directory.
Command
ID
Description
CodeTrace: Toggle Inline Blame
codetrace.toggleBlame
Show/hide inline blame annotations
CodeTrace: Show File History
codetrace.showFileHistory
Open the file history sidebar panel
CodeTrace: Show Sidebar
codetrace.showSidebar
Open the CodeTrace sidebar
CodeTrace: Toggle Status Bar
codetrace.toggleStatusBar
Show/hide the status bar item
CodeTrace: Detect Plugin Conflicts
codetrace.detectConflicts
Manually trigger plugin conflict detection
Configuration
All settings are under codetrace.* in VS Code settings:
Setting
Default
Description
codetrace.enabled
true
Master enable/disable switch
codetrace.idleSleep.enabled
true
Put Git queries to sleep after idle timeout
codetrace.idleSleep.timeout
300
Idle timeout in seconds
codetrace.blame.fontSize
"0.8em"
Font size for inline blame text
codetrace.blame.opacity
0.55
Opacity for inline blame text (0-1)
codetrace.blame.color
"auto"
Color ("auto" follows theme)
codetrace.ignore.patterns
[...]
Glob patterns to exclude from blame
codetrace.ignore.useGitignore
true
Also respect .gitignore
codetrace.fileSizeLimit
20000
Max file lines for inline blame (0 = unlimited)
codetrace.cache.maxCommits
20
Commits cached per workspace
codetrace.logLevel
"info"
Log level: "debug", "info", "warn", or "error"
Contributing
Contributions are welcome! Please ensure:
All code passes ESLint (npm run lint)
All tests pass with coverage (npm test)
New features include unit tests
Functions have JSDoc comments
License
This project is licensed under the MIT License. See the LICENSE file for details.
