BranchesTags

Repository files navigation

Diff Detective

Diff Detective is an AI-powered git commit review tool that helps catch issues before they're pushed to the repository.

Goal

To provide an automated review of staged changes in a git repository. it aims to:

  1. Identify potential bugs or issues in the code (be it serious ones, like blatant race conditions, to less serious ones like forgotten debug statements)
  2. Catch common mistakes or oversights
  3. Provide context-aware insights that a traditional linter might miss

Features

  • AI-powered analysis of staged git changes
  • Identification of bugs, potential issues, and code smells
  • Easy-to-use command-line interface
  • Configurable prompt, model, provider, max tokens, api key...

Usage

To install:

pnpm install -g diff-detective

The default model is Sonnet 3.5 from Anthropic.

For each provider you use, you need an API key. You can set it

  • as an environment variable in the system (OPENAI_API_KEY, ANTHROPIC_API_KEY etc.),
  • always pass it as a CLI argument (detective review --api-key your-api-key)
  • save it to the config file (detective set-api-key your-api-key)

To use Diff Detective, simply run detective or dd (because we are lazy) in the root of your project.

This will analyze your currently staged changes and provide a detailed report.

Example parameter usage:

detective --model gpt-4o --prompt-path "./my-custom-review-prompt.txt"
dd --prompt "See any issues in the database refactor?" -m "o1-mini" --ignore pnpm-lock.yaml dist/

Example of setting defaults:

detective set-provider anthropic
detective set-model claude-3-5-sonnet-20240620
detective set-api-key "your-api-key"
detective set-ignored-files dist/ pnpm-lock.yaml android/ ios/
detective get-config
detective clear-config

To see all available options, run

detective --help

Supported models

Diff Detective currently supports OpenAi, Anthropic and OpenRouter as providers. You can use any model available with these providers (given you have an API key). More to come.

How It Works

Diff Detective integrates into your git workflow as follows:

  1. You stage your changes as usual with git add
  2. Before committing, you run Diff Detective
  3. The tool analyzes your staged changes using AI
  4. It provides a detailed report of findings and suggestions, outputs to the console
  5. You can then review the AI's feedback and make any necessary adjustments before committing

To-Do

  • Custom prompt configurable via config, not only using CLI arguments
  • ? Smarter algorithm for extracting code change context. Currently, the AI only sees the changed files. It might be beneficial to include additional context like repo map, related files, or just general info about the project.
  • Configurable array of ignored files (pnpm-lock.yaml, dist...) - both global and repo-specific
  • Streaming support
  • manual inclusion of additional files using CLI params
  • More providers (Google, Mistral, Deepseek, Groq)
  • Better prompt (that's an uphill battle)
  • ? Better output formatting of code blocks
  • a --fail mode, which fails the command if it found a bug that it is confident in. Useful for automatic pre-commit testing where the commit would fail in case of a found bug.

About

AI-powered git commit review tool that helps developers improve their code quality and catch potential issues before they're pushed to the repository.

www.npmjs.com/package/diff-detective

Resources

Readme
MIT license
Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Diff Detective
Diff Detective is an AI-powered git commit review tool that helps catch
issues before they're pushed to the repository.
Goal
To provide an automated review of staged changes in a git repository.
it aims to:
  1. Identify potential bugs or issues in the code (be it serious ones, like blatant race conditions, to less serious ones like forgotten debug statements)
  2. Catch common mistakes or oversights
  3. Provide context-aware insights that a traditional linter might miss
Features
  • AI-powered analysis of staged git changes
  • Identification of bugs, potential issues, and code smells
  • Easy-to-use command-line interface
  • Configurable prompt, model, provider, max tokens, api key...
Usage
To install:
pnpm install -g diff-detective
The default model is Sonnet 3.5 from Anthropic.
For each provider you use, you need an API key. You can set it
  • as an environment variable in the system (OPENAI_API_KEY, ANTHROPIC_API_KEY etc.),
  • always pass it as a CLI argument (detective review --api-key your-api-key)
  • save it to the config file (detective set-api-key your-api-key)
To use Diff Detective, simply run detective or dd (because we are lazy) in the root of your project.
This will analyze your currently staged changes and provide a detailed report.
Example parameter usage:
detective --model gpt-4o --prompt-path "./my-custom-review-prompt.txt"
dd --prompt "See any issues in the database refactor?" -m "o1-mini" --ignore pnpm-lock.yaml dist/
Example of setting defaults:
detective set-provider anthropic
detective set-model claude-3-5-sonnet-20240620
detective set-api-key "your-api-key"
detective set-ignored-files dist/ pnpm-lock.yaml android/ ios/
detective get-config
detective clear-config
To see all available options, run
detective --help
Supported models
Diff Detective currently supports OpenAi, Anthropic and OpenRouter as providers. You can use any model available with these providers (given you have an API key). More to come.
How It Works
Diff Detective integrates into your git workflow as follows:
  1. You stage your changes as usual with git add
  2. Before committing, you run Diff Detective
  3. The tool analyzes your staged changes using AI
  4. It provides a detailed report of findings and suggestions, outputs to the console
  5. You can then review the AI's feedback and make any necessary adjustments before committing
To-Do
  •  Custom prompt configurable via config, not only using CLI arguments
  •  ? Smarter algorithm for extracting code change context. Currently, the AI only sees the changed files. It might be beneficial to include additional context like repo map, related files, or just general info about the project.
  •  Configurable array of ignored files (pnpm-lock.yaml, dist...) - both global and repo-specific
  •  Streaming support
  •  manual inclusion of additional files using CLI params
  •  More providers (Google, Mistral, Deepseek, Groq)
  •  Better prompt (that's an uphill battle)
  •  ? Better output formatting of code blocks
  •  a --fail mode, which fails the command if it found a bug that it is confident in. Useful for automatic pre-commit testing where the commit would fail in case of a found bug.
About
AI-powered git commit review tool that helps developers improve their code quality and catch potential issues before they're pushed to the repository.
www.npmjs.com/package/diff-detective
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Diff Detective
Diff Detective is an AI-powered git commit review tool that helps catch
issues before they're pushed to the repository.
Goal
To provide an automated review of staged changes in a git repository.
it aims to:
  1. Identify potential bugs or issues in the code (be it serious ones, like blatant race conditions, to less serious ones like forgotten debug statements)
  2. Catch common mistakes or oversights
  3. Provide context-aware insights that a traditional linter might miss
Features
  • AI-powered analysis of staged git changes
  • Identification of bugs, potential issues, and code smells
  • Easy-to-use command-line interface
  • Configurable prompt, model, provider, max tokens, api key...
Usage
To install:
pnpm install -g diff-detective
The default model is Sonnet 3.5 from Anthropic.
For each provider you use, you need an API key. You can set it
  • as an environment variable in the system (OPENAI_API_KEY, ANTHROPIC_API_KEY etc.),
  • always pass it as a CLI argument (detective review --api-key your-api-key)
  • save it to the config file (detective set-api-key your-api-key)
To use Diff Detective, simply run detective or dd (because we are lazy) in the root of your project.
This will analyze your currently staged changes and provide a detailed report.
Example parameter usage:
detective --model gpt-4o --prompt-path "./my-custom-review-prompt.txt"
dd --prompt "See any issues in the database refactor?" -m "o1-mini" --ignore pnpm-lock.yaml dist/
Example of setting defaults:
detective set-provider anthropic
detective set-model claude-3-5-sonnet-20240620
detective set-api-key "your-api-key"
detective set-ignored-files dist/ pnpm-lock.yaml android/ ios/
detective get-config
detective clear-config
To see all available options, run
detective --help
Supported models
Diff Detective currently supports OpenAi, Anthropic and OpenRouter as providers. You can use any model available with these providers (given you have an API key). More to come.
How It Works
Diff Detective integrates into your git workflow as follows:
  1. You stage your changes as usual with git add
  2. Before committing, you run Diff Detective
  3. The tool analyzes your staged changes using AI
  4. It provides a detailed report of findings and suggestions, outputs to the console
  5. You can then review the AI's feedback and make any necessary adjustments before committing
To-Do
  •  Custom prompt configurable via config, not only using CLI arguments
  •  ? Smarter algorithm for extracting code change context. Currently, the AI only sees the changed files. It might be beneficial to include additional context like repo map, related files, or just general info about the project.
  •  Configurable array of ignored files (pnpm-lock.yaml, dist...) - both global and repo-specific
  •  Streaming support
  •  manual inclusion of additional files using CLI params
  •  More providers (Google, Mistral, Deepseek, Groq)
  •  Better prompt (that's an uphill battle)
  •  ? Better output formatting of code blocks
  •  a --fail mode, which fails the command if it found a bug that it is confident in. Useful for automatic pre-commit testing where the commit would fail in case of a found bug.
About
AI-powered git commit review tool that helps developers improve their code quality and catch potential issues before they're pushed to the repository.
www.npmjs.com/package/diff-detective
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Diff Detective
Diff Detective is an AI-powered git commit review tool that helps catch
issues before they're pushed to the repository.
Goal
To provide an automated review of staged changes in a git repository.
it aims to:
  1. Identify potential bugs or issues in the code (be it serious ones, like blatant race conditions, to less serious ones like forgotten debug statements)
  2. Catch common mistakes or oversights
  3. Provide context-aware insights that a traditional linter might miss
Features
  • AI-powered analysis of staged git changes
  • Identification of bugs, potential issues, and code smells
  • Easy-to-use command-line interface
  • Configurable prompt, model, provider, max tokens, api key...
Usage
To install:
pnpm install -g diff-detective
The default model is Sonnet 3.5 from Anthropic.
For each provider you use, you need an API key. You can set it
  • as an environment variable in the system (OPENAI_API_KEY, ANTHROPIC_API_KEY etc.),
  • always pass it as a CLI argument (detective review --api-key your-api-key)
  • save it to the config file (detective set-api-key your-api-key)
To use Diff Detective, simply run detective or dd (because we are lazy) in the root of your project.
This will analyze your currently staged changes and provide a detailed report.
Example parameter usage:
detective --model gpt-4o --prompt-path "./my-custom-review-prompt.txt"
dd --prompt "See any issues in the database refactor?" -m "o1-mini" --ignore pnpm-lock.yaml dist/
Example of setting defaults:
detective set-provider anthropic
detective set-model claude-3-5-sonnet-20240620
detective set-api-key "your-api-key"
detective set-ignored-files dist/ pnpm-lock.yaml android/ ios/
detective get-config
detective clear-config
To see all available options, run
detective --help
Supported models
Diff Detective currently supports OpenAi, Anthropic and OpenRouter as providers. You can use any model available with these providers (given you have an API key). More to come.
How It Works
Diff Detective integrates into your git workflow as follows:
  1. You stage your changes as usual with git add
  2. Before committing, you run Diff Detective
  3. The tool analyzes your staged changes using AI
  4. It provides a detailed report of findings and suggestions, outputs to the console
  5. You can then review the AI's feedback and make any necessary adjustments before committing
To-Do
  •  Custom prompt configurable via config, not only using CLI arguments
  •  ? Smarter algorithm for extracting code change context. Currently, the AI only sees the changed files. It might be beneficial to include additional context like repo map, related files, or just general info about the project.
  •  Configurable array of ignored files (pnpm-lock.yaml, dist...) - both global and repo-specific
  •  Streaming support
  •  manual inclusion of additional files using CLI params
  •  More providers (Google, Mistral, Deepseek, Groq)
  •  Better prompt (that's an uphill battle)
  •  ? Better output formatting of code blocks
  •  a --fail mode, which fails the command if it found a bug that it is confident in. Useful for automatic pre-commit testing where the commit would fail in case of a found bug.
About
AI-powered git commit review tool that helps developers improve their code quality and catch potential issues before they're pushed to the repository.
www.npmjs.com/package/diff-detective
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Diff Detective
Diff Detective is an AI-powered git commit review tool that helps catch
issues before they're pushed to the repository.
Goal
To provide an automated review of staged changes in a git repository.
it aims to:
  1. Identify potential bugs or issues in the code (be it serious ones, like blatant race conditions, to less serious ones like forgotten debug statements)
  2. Catch common mistakes or oversights
  3. Provide context-aware insights that a traditional linter might miss
Features
  • AI-powered analysis of staged git changes
  • Identification of bugs, potential issues, and code smells
  • Easy-to-use command-line interface
  • Configurable prompt, model, provider, max tokens, api key...
Usage
To install:
pnpm install -g diff-detective
The default model is Sonnet 3.5 from Anthropic.
For each provider you use, you need an API key. You can set it
  • as an environment variable in the system (OPENAI_API_KEY, ANTHROPIC_API_KEY etc.),
  • always pass it as a CLI argument (detective review --api-key your-api-key)
  • save it to the config file (detective set-api-key your-api-key)
To use Diff Detective, simply run detective or dd (because we are lazy) in the root of your project.
This will analyze your currently staged changes and provide a detailed report.
Example parameter usage:
detective --model gpt-4o --prompt-path "./my-custom-review-prompt.txt"
dd --prompt "See any issues in the database refactor?" -m "o1-mini" --ignore pnpm-lock.yaml dist/
Example of setting defaults:
detective set-provider anthropic
detective set-model claude-3-5-sonnet-20240620
detective set-api-key "your-api-key"
detective set-ignored-files dist/ pnpm-lock.yaml android/ ios/
detective get-config
detective clear-config
To see all available options, run
detective --help
Supported models
Diff Detective currently supports OpenAi, Anthropic and OpenRouter as providers. You can use any model available with these providers (given you have an API key). More to come.
How It Works
Diff Detective integrates into your git workflow as follows:
  1. You stage your changes as usual with git add
  2. Before committing, you run Diff Detective
  3. The tool analyzes your staged changes using AI
  4. It provides a detailed report of findings and suggestions, outputs to the console
  5. You can then review the AI's feedback and make any necessary adjustments before committing
To-Do
  •  Custom prompt configurable via config, not only using CLI arguments
  •  ? Smarter algorithm for extracting code change context. Currently, the AI only sees the changed files. It might be beneficial to include additional context like repo map, related files, or just general info about the project.
  •  Configurable array of ignored files (pnpm-lock.yaml, dist...) - both global and repo-specific
  •  Streaming support
  •  manual inclusion of additional files using CLI params
  •  More providers (Google, Mistral, Deepseek, Groq)
  •  Better prompt (that's an uphill battle)
  •  ? Better output formatting of code blocks
  •  a --fail mode, which fails the command if it found a bug that it is confident in. Useful for automatic pre-commit testing where the commit would fail in case of a found bug.
About
AI-powered git commit review tool that helps developers improve their code quality and catch potential issues before they're pushed to the repository.
www.npmjs.com/package/diff-detective
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Diff Detective
Diff Detective is an AI-powered git commit review tool that helps catch
issues before they're pushed to the repository.
Goal
To provide an automated review of staged changes in a git repository.
it aims to:
  1. Identify potential bugs or issues in the code (be it serious ones, like blatant race conditions, to less serious ones like forgotten debug statements)
  2. Catch common mistakes or oversights
  3. Provide context-aware insights that a traditional linter might miss
Features
  • AI-powered analysis of staged git changes
  • Identification of bugs, potential issues, and code smells
  • Easy-to-use command-line interface
  • Configurable prompt, model, provider, max tokens, api key...
Usage
To install:
pnpm install -g diff-detective
The default model is Sonnet 3.5 from Anthropic.
For each provider you use, you need an API key. You can set it
  • as an environment variable in the system (OPENAI_API_KEY, ANTHROPIC_API_KEY etc.),
  • always pass it as a CLI argument (detective review --api-key your-api-key)
  • save it to the config file (detective set-api-key your-api-key)
To use Diff Detective, simply run detective or dd (because we are lazy) in the root of your project.
This will analyze your currently staged changes and provide a detailed report.
Example parameter usage:
detective --model gpt-4o --prompt-path "./my-custom-review-prompt.txt"
dd --prompt "See any issues in the database refactor?" -m "o1-mini" --ignore pnpm-lock.yaml dist/
Example of setting defaults:
detective set-provider anthropic
detective set-model claude-3-5-sonnet-20240620
detective set-api-key "your-api-key"
detective set-ignored-files dist/ pnpm-lock.yaml android/ ios/
detective get-config
detective clear-config
To see all available options, run
detective --help
Supported models
Diff Detective currently supports OpenAi, Anthropic and OpenRouter as providers. You can use any model available with these providers (given you have an API key). More to come.
How It Works
Diff Detective integrates into your git workflow as follows:
  1. You stage your changes as usual with git add
  2. Before committing, you run Diff Detective
  3. The tool analyzes your staged changes using AI
  4. It provides a detailed report of findings and suggestions, outputs to the console
  5. You can then review the AI's feedback and make any necessary adjustments before committing
To-Do
  •  Custom prompt configurable via config, not only using CLI arguments
  •  ? Smarter algorithm for extracting code change context. Currently, the AI only sees the changed files. It might be beneficial to include additional context like repo map, related files, or just general info about the project.
  •  Configurable array of ignored files (pnpm-lock.yaml, dist...) - both global and repo-specific
  •  Streaming support
  •  manual inclusion of additional files using CLI params
  •  More providers (Google, Mistral, Deepseek, Groq)
  •  Better prompt (that's an uphill battle)
  •  ? Better output formatting of code blocks
  •  a --fail mode, which fails the command if it found a bug that it is confident in. Useful for automatic pre-commit testing where the commit would fail in case of a found bug.
About
AI-powered git commit review tool that helps developers improve their code quality and catch potential issues before they're pushed to the repository.
www.npmjs.com/package/diff-detective
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Diff Detective
Diff Detective is an AI-powered git commit review tool that helps catch
issues before they're pushed to the repository.
Goal
To provide an automated review of staged changes in a git repository.
it aims to:
  1. Identify potential bugs or issues in the code (be it serious ones, like blatant race conditions, to less serious ones like forgotten debug statements)
  2. Catch common mistakes or oversights
  3. Provide context-aware insights that a traditional linter might miss
Features
  • AI-powered analysis of staged git changes
  • Identification of bugs, potential issues, and code smells
  • Easy-to-use command-line interface
  • Configurable prompt, model, provider, max tokens, api key...
Usage
To install:
pnpm install -g diff-detective
The default model is Sonnet 3.5 from Anthropic.
For each provider you use, you need an API key. You can set it
  • as an environment variable in the system (OPENAI_API_KEY, ANTHROPIC_API_KEY etc.),
  • always pass it as a CLI argument (detective review --api-key your-api-key)
  • save it to the config file (detective set-api-key your-api-key)
To use Diff Detective, simply run detective or dd (because we are lazy) in the root of your project.
This will analyze your currently staged changes and provide a detailed report.
Example parameter usage:
detective --model gpt-4o --prompt-path "./my-custom-review-prompt.txt"
dd --prompt "See any issues in the database refactor?" -m "o1-mini" --ignore pnpm-lock.yaml dist/
Example of setting defaults:
detective set-provider anthropic
detective set-model claude-3-5-sonnet-20240620
detective set-api-key "your-api-key"
detective set-ignored-files dist/ pnpm-lock.yaml android/ ios/
detective get-config
detective clear-config
To see all available options, run
detective --help
Supported models
Diff Detective currently supports OpenAi, Anthropic and OpenRouter as providers. You can use any model available with these providers (given you have an API key). More to come.
How It Works
Diff Detective integrates into your git workflow as follows:
  1. You stage your changes as usual with git add
  2. Before committing, you run Diff Detective
  3. The tool analyzes your staged changes using AI
  4. It provides a detailed report of findings and suggestions, outputs to the console
  5. You can then review the AI's feedback and make any necessary adjustments before committing
To-Do
  •  Custom prompt configurable via config, not only using CLI arguments
  •  ? Smarter algorithm for extracting code change context. Currently, the AI only sees the changed files. It might be beneficial to include additional context like repo map, related files, or just general info about the project.
  •  Configurable array of ignored files (pnpm-lock.yaml, dist...) - both global and repo-specific
  •  Streaming support
  •  manual inclusion of additional files using CLI params
  •  More providers (Google, Mistral, Deepseek, Groq)
  •  Better prompt (that's an uphill battle)
  •  ? Better output formatting of code blocks
  •  a --fail mode, which fails the command if it found a bug that it is confident in. Useful for automatic pre-commit testing where the commit would fail in case of a found bug.
About
AI-powered git commit review tool that helps developers improve their code quality and catch potential issues before they're pushed to the repository.
www.npmjs.com/package/diff-detective
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
Diff Detective
Diff Detective is an AI-powered git commit review tool that helps catch
issues before they're pushed to the repository.
Goal
To provide an automated review of staged changes in a git repository.
it aims to:
  1. Identify potential bugs or issues in the code (be it serious ones, like blatant race conditions, to less serious ones like forgotten debug statements)
  2. Catch common mistakes or oversights
  3. Provide context-aware insights that a traditional linter might miss
Features
  • AI-powered analysis of staged git changes
  • Identification of bugs, potential issues, and code smells
  • Easy-to-use command-line interface
  • Configurable prompt, model, provider, max tokens, api key...
Usage
To install:
pnpm install -g diff-detective
The default model is Sonnet 3.5 from Anthropic.
For each provider you use, you need an API key. You can set it
  • as an environment variable in the system (OPENAI_API_KEY, ANTHROPIC_API_KEY etc.),
  • always pass it as a CLI argument (detective review --api-key your-api-key)
  • save it to the config file (detective set-api-key your-api-key)
To use Diff Detective, simply run detective or dd (because we are lazy) in the root of your project.
This will analyze your currently staged changes and provide a detailed report.
Example parameter usage:
detective --model gpt-4o --prompt-path "./my-custom-review-prompt.txt"
dd --prompt "See any issues in the database refactor?" -m "o1-mini" --ignore pnpm-lock.yaml dist/
Example of setting defaults:
detective set-provider anthropic
detective set-model claude-3-5-sonnet-20240620
detective set-api-key "your-api-key"
detective set-ignored-files dist/ pnpm-lock.yaml android/ ios/
detective get-config
detective clear-config
To see all available options, run
detective --help
Supported models
Diff Detective currently supports OpenAi, Anthropic and OpenRouter as providers. You can use any model available with these providers (given you have an API key). More to come.
How It Works
Diff Detective integrates into your git workflow as follows:
  1. You stage your changes as usual with git add
  2. Before committing, you run Diff Detective
  3. The tool analyzes your staged changes using AI
  4. It provides a detailed report of findings and suggestions, outputs to the console
  5. You can then review the AI's feedback and make any necessary adjustments before committing
To-Do
  •  Custom prompt configurable via config, not only using CLI arguments
  •  ? Smarter algorithm for extracting code change context. Currently, the AI only sees the changed files. It might be beneficial to include additional context like repo map, related files, or just general info about the project.
  •  Configurable array of ignored files (pnpm-lock.yaml, dist...) - both global and repo-specific
  •  Streaming support
  •  manual inclusion of additional files using CLI params
  •  More providers (Google, Mistral, Deepseek, Groq)
  •  Better prompt (that's an uphill battle)
  •  ? Better output formatting of code blocks
  •  a --fail mode, which fails the command if it found a bug that it is confident in. Useful for automatic pre-commit testing where the commit would fail in case of a found bug.
About
AI-powered git commit review tool that helps developers improve their code quality and catch potential issues before they're pushed to the repository.
www.npmjs.com/package/diff-detective
Resources
Readme
MIT license
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages