Repository files navigation

aicommit

aicommit is a small command line tool for generating commit messages. There are many of these already out there, some even with the same name. But none (to my knowledge) follow the repository's existing style, making them useless when working in an established codebase.

A good commit message is more than a summary of the code changes. It contains the intention, context, and external references that help others understand the change. Thus, aicommit has a -c/--context flag for quickly adding this detail.

aicommit is inspired by our good friend @sreya:

sreya-log

Install

Via Homebrew:

brew install aicommit

Or, using Go:

go install github.com/coder/aicommit/cmd/aicommit@main

Or, download a binary from the latest release.

Usage

You can run aicommit with no arguments to generate a commit message for the staged changes.

export OPENAI_API_KEY="..."
aicommit

You can "retry" a commit message by using the -a/--amend flag.

aicommit -a

You can dry-run with -d/--dry to see the ideal message without committing.

aicommit -d

Or, you can point to a specific ref:

aicommit HEAD~3

You can also provide context to the AI to help it generate a better commit message:

aicommit -c "closes #123"
aicommit -c "improved HTTP performance by 50%"
aicommit -c "bad code but need for urgent customer fix"

When tired of setting environment variables, you can save your key to disk:

export OPENAI_API_KEY="..."
aicommit --save-key
# The environment variable will override the saved key.

Style Guide

aicommit will read the COMMITS.md file in the root of the repository to determine the style guide. It is optional, but if it exists, it will be followed even if the rules there diverge from the norm.

If there is no repo style guide, aicommit will look for a user style guide in ~/COMMITS.md.

Other Providers

You may set OPENAI_BASE_URL to use other OpenAI compatible APIs with aicommit. So far, I've tested it with LiteLLM across local models (via ollama) and Anthropic. I have yet to find a local model that is well-steered by the prompt design here, but the Anthropic Claude 3.5 commit messages are on par with 4o. My theory for why local models don't work well is they (incl. "Instruct" models) have much worse instruction fine-tuning than flagship commercial models.

About

become the world's laziest committer

Topics

Resources

Code of conduct

Security policy

Stars

184 stars

Watchers

0 watching

Forks

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

Repository files navigation

aicommit

aicommit is a small command line tool for generating commit messages. There are many of these already out there, some even with the same name. But none (to my knowledge) follow the repository's existing style, making them useless when working in an established codebase.

A good commit message is more than a summary of the code changes. It contains the intention, context, and external references that help others understand the change. Thus, aicommit has a -c/--context flag for quickly adding this detail.

aicommit is inspired by our good friend @sreya:

sreya-log

Install

Via Homebrew:

brew install aicommit

Or, using Go:

go install github.com/coder/aicommit/cmd/aicommit@main

Or, download a binary from the latest release.

Usage

You can run aicommit with no arguments to generate a commit message for the staged changes.

export OPENAI_API_KEY="..."
aicommit

You can "retry" a commit message by using the -a/--amend flag.

aicommit -a

You can dry-run with -d/--dry to see the ideal message without committing.

aicommit -d

Or, you can point to a specific ref:

aicommit HEAD~3

You can also provide context to the AI to help it generate a better commit message:

aicommit -c "closes #123"
aicommit -c "improved HTTP performance by 50%"
aicommit -c "bad code but need for urgent customer fix"

When tired of setting environment variables, you can save your key to disk:

export OPENAI_API_KEY="..."
aicommit --save-key
# The environment variable will override the saved key.

Style Guide

aicommit will read the COMMITS.md file in the root of the repository to determine the style guide. It is optional, but if it exists, it will be followed even if the rules there diverge from the norm.

If there is no repo style guide, aicommit will look for a user style guide in ~/COMMITS.md.

Other Providers

You may set OPENAI_BASE_URL to use other OpenAI compatible APIs with aicommit. So far, I've tested it with LiteLLM across local models (via ollama) and Anthropic. I have yet to find a local model that is well-steered by the prompt design here, but the Anthropic Claude 3.5 commit messages are on par with 4o. My theory for why local models don't work well is they (incl. "Instruct" models) have much worse instruction fine-tuning than flagship commercial models.

About

become the world's laziest committer

Topics

Resources

Code of conduct

Security policy

Stars

184 stars

Watchers

0 watching

Forks

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

Repository files navigation

aicommit

aicommit is a small command line tool for generating commit messages. There are many of these already out there, some even with the same name. But none (to my knowledge) follow the repository's existing style, making them useless when working in an established codebase.

A good commit message is more than a summary of the code changes. It contains the intention, context, and external references that help others understand the change. Thus, aicommit has a -c/--context flag for quickly adding this detail.

aicommit is inspired by our good friend @sreya:

sreya-log

Install

Via Homebrew:

brew install aicommit

Or, using Go:

go install github.com/coder/aicommit/cmd/aicommit@main

Or, download a binary from the latest release.

Usage

You can run aicommit with no arguments to generate a commit message for the staged changes.

export OPENAI_API_KEY="..."
aicommit

You can "retry" a commit message by using the -a/--amend flag.

aicommit -a

You can dry-run with -d/--dry to see the ideal message without committing.

aicommit -d

Or, you can point to a specific ref:

aicommit HEAD~3

You can also provide context to the AI to help it generate a better commit message:

aicommit -c "closes #123"
aicommit -c "improved HTTP performance by 50%"
aicommit -c "bad code but need for urgent customer fix"

When tired of setting environment variables, you can save your key to disk:

export OPENAI_API_KEY="..."
aicommit --save-key
# The environment variable will override the saved key.

Style Guide

aicommit will read the COMMITS.md file in the root of the repository to determine the style guide. It is optional, but if it exists, it will be followed even if the rules there diverge from the norm.

If there is no repo style guide, aicommit will look for a user style guide in ~/COMMITS.md.

Other Providers

You may set OPENAI_BASE_URL to use other OpenAI compatible APIs with aicommit. So far, I've tested it with LiteLLM across local models (via ollama) and Anthropic. I have yet to find a local model that is well-steered by the prompt design here, but the Anthropic Claude 3.5 commit messages are on par with 4o. My theory for why local models don't work well is they (incl. "Instruct" models) have much worse instruction fine-tuning than flagship commercial models.

About

become the world's laziest committer

Topics

Resources

Code of conduct

Security policy

Stars

184 stars

Watchers

0 watching

Forks

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

Repository files navigation

aicommit

aicommit is a small command line tool for generating commit messages. There are many of these already out there, some even with the same name. But none (to my knowledge) follow the repository's existing style, making them useless when working in an established codebase.

A good commit message is more than a summary of the code changes. It contains the intention, context, and external references that help others understand the change. Thus, aicommit has a -c/--context flag for quickly adding this detail.

aicommit is inspired by our good friend @sreya:

sreya-log

Install

Via Homebrew:

brew install aicommit

Or, using Go:

go install github.com/coder/aicommit/cmd/aicommit@main

Or, download a binary from the latest release.

Usage

You can run aicommit with no arguments to generate a commit message for the staged changes.

export OPENAI_API_KEY="..."
aicommit

You can "retry" a commit message by using the -a/--amend flag.

aicommit -a

You can dry-run with -d/--dry to see the ideal message without committing.

aicommit -d

Or, you can point to a specific ref:

aicommit HEAD~3

You can also provide context to the AI to help it generate a better commit message:

aicommit -c "closes #123"
aicommit -c "improved HTTP performance by 50%"
aicommit -c "bad code but need for urgent customer fix"

When tired of setting environment variables, you can save your key to disk:

export OPENAI_API_KEY="..."
aicommit --save-key
# The environment variable will override the saved key.

Style Guide

aicommit will read the COMMITS.md file in the root of the repository to determine the style guide. It is optional, but if it exists, it will be followed even if the rules there diverge from the norm.

If there is no repo style guide, aicommit will look for a user style guide in ~/COMMITS.md.

Other Providers

You may set OPENAI_BASE_URL to use other OpenAI compatible APIs with aicommit. So far, I've tested it with LiteLLM across local models (via ollama) and Anthropic. I have yet to find a local model that is well-steered by the prompt design here, but the Anthropic Claude 3.5 commit messages are on par with 4o. My theory for why local models don't work well is they (incl. "Instruct" models) have much worse instruction fine-tuning than flagship commercial models.

About

become the world's laziest committer

Topics

Resources

Code of conduct

Security policy

Stars

184 stars

Watchers

0 watching

Forks

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

Repository files navigation

aicommit

aicommit is a small command line tool for generating commit messages. There are many of these already out there, some even with the same name. But none (to my knowledge) follow the repository's existing style, making them useless when working in an established codebase.

A good commit message is more than a summary of the code changes. It contains the intention, context, and external references that help others understand the change. Thus, aicommit has a -c/--context flag for quickly adding this detail.

aicommit is inspired by our good friend @sreya:

sreya-log

Install

Via Homebrew:

brew install aicommit

Or, using Go:

go install github.com/coder/aicommit/cmd/aicommit@main

Or, download a binary from the latest release.

Usage

You can run aicommit with no arguments to generate a commit message for the staged changes.

export OPENAI_API_KEY="..."
aicommit

You can "retry" a commit message by using the -a/--amend flag.

aicommit -a

You can dry-run with -d/--dry to see the ideal message without committing.

aicommit -d

Or, you can point to a specific ref:

aicommit HEAD~3

You can also provide context to the AI to help it generate a better commit message:

aicommit -c "closes #123"
aicommit -c "improved HTTP performance by 50%"
aicommit -c "bad code but need for urgent customer fix"

When tired of setting environment variables, you can save your key to disk:

export OPENAI_API_KEY="..."
aicommit --save-key
# The environment variable will override the saved key.

Style Guide

aicommit will read the COMMITS.md file in the root of the repository to determine the style guide. It is optional, but if it exists, it will be followed even if the rules there diverge from the norm.

If there is no repo style guide, aicommit will look for a user style guide in ~/COMMITS.md.

Other Providers

You may set OPENAI_BASE_URL to use other OpenAI compatible APIs with aicommit. So far, I've tested it with LiteLLM across local models (via ollama) and Anthropic. I have yet to find a local model that is well-steered by the prompt design here, but the Anthropic Claude 3.5 commit messages are on par with 4o. My theory for why local models don't work well is they (incl. "Instruct" models) have much worse instruction fine-tuning than flagship commercial models.

About

become the world's laziest committer

Topics

Resources

Code of conduct

Security policy

Stars

184 stars

Watchers

0 watching

Forks

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

Repository files navigation

aicommit

aicommit is a small command line tool for generating commit messages. There are many of these already out there, some even with the same name. But none (to my knowledge) follow the repository's existing style, making them useless when working in an established codebase.

A good commit message is more than a summary of the code changes. It contains the intention, context, and external references that help others understand the change. Thus, aicommit has a -c/--context flag for quickly adding this detail.

aicommit is inspired by our good friend @sreya:

sreya-log

Install

Via Homebrew:

brew install aicommit

Or, using Go:

go install github.com/coder/aicommit/cmd/aicommit@main

Or, download a binary from the latest release.

Usage

You can run aicommit with no arguments to generate a commit message for the staged changes.

export OPENAI_API_KEY="..."
aicommit

You can "retry" a commit message by using the -a/--amend flag.

aicommit -a

You can dry-run with -d/--dry to see the ideal message without committing.

aicommit -d

Or, you can point to a specific ref:

aicommit HEAD~3

You can also provide context to the AI to help it generate a better commit message:

aicommit -c "closes #123"
aicommit -c "improved HTTP performance by 50%"
aicommit -c "bad code but need for urgent customer fix"

When tired of setting environment variables, you can save your key to disk:

export OPENAI_API_KEY="..."
aicommit --save-key
# The environment variable will override the saved key.

Style Guide

aicommit will read the COMMITS.md file in the root of the repository to determine the style guide. It is optional, but if it exists, it will be followed even if the rules there diverge from the norm.

If there is no repo style guide, aicommit will look for a user style guide in ~/COMMITS.md.

Other Providers

You may set OPENAI_BASE_URL to use other OpenAI compatible APIs with aicommit. So far, I've tested it with LiteLLM across local models (via ollama) and Anthropic. I have yet to find a local model that is well-steered by the prompt design here, but the Anthropic Claude 3.5 commit messages are on par with 4o. My theory for why local models don't work well is they (incl. "Instruct" models) have much worse instruction fine-tuning than flagship commercial models.

About

become the world's laziest committer

Topics

Resources

Code of conduct

Security policy

Stars

184 stars

Watchers

0 watching

Forks

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

Repository files navigation

aicommit

aicommit is a small command line tool for generating commit messages. There are many of these already out there, some even with the same name. But none (to my knowledge) follow the repository's existing style, making them useless when working in an established codebase.

A good commit message is more than a summary of the code changes. It contains the intention, context, and external references that help others understand the change. Thus, aicommit has a -c/--context flag for quickly adding this detail.

aicommit is inspired by our good friend @sreya:

sreya-log

Install

Via Homebrew:

brew install aicommit

Or, using Go:

go install github.com/coder/aicommit/cmd/aicommit@main

Or, download a binary from the latest release.

Usage

You can run aicommit with no arguments to generate a commit message for the staged changes.

export OPENAI_API_KEY="..."
aicommit

You can "retry" a commit message by using the -a/--amend flag.

aicommit -a

You can dry-run with -d/--dry to see the ideal message without committing.

aicommit -d

Or, you can point to a specific ref:

aicommit HEAD~3

You can also provide context to the AI to help it generate a better commit message:

aicommit -c "closes #123"
aicommit -c "improved HTTP performance by 50%"
aicommit -c "bad code but need for urgent customer fix"

When tired of setting environment variables, you can save your key to disk:

export OPENAI_API_KEY="..."
aicommit --save-key
# The environment variable will override the saved key.

Style Guide

aicommit will read the COMMITS.md file in the root of the repository to determine the style guide. It is optional, but if it exists, it will be followed even if the rules there diverge from the norm.

If there is no repo style guide, aicommit will look for a user style guide in ~/COMMITS.md.

Other Providers

You may set OPENAI_BASE_URL to use other OpenAI compatible APIs with aicommit. So far, I've tested it with LiteLLM across local models (via ollama) and Anthropic. I have yet to find a local model that is well-steered by the prompt design here, but the Anthropic Claude 3.5 commit messages are on par with 4o. My theory for why local models don't work well is they (incl. "Instruct" models) have much worse instruction fine-tuning than flagship commercial models.

About

become the world's laziest committer

Topics

Resources

Code of conduct

Security policy

Stars

184 stars

Watchers

0 watching

Forks

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

Repository files navigation

aicommit

aicommit is a small command line tool for generating commit messages. There are many of these already out there, some even with the same name. But none (to my knowledge) follow the repository's existing style, making them useless when working in an established codebase.

A good commit message is more than a summary of the code changes. It contains the intention, context, and external references that help others understand the change. Thus, aicommit has a -c/--context flag for quickly adding this detail.

aicommit is inspired by our good friend @sreya:

sreya-log

Install

Via Homebrew:

brew install aicommit

Or, using Go:

go install github.com/coder/aicommit/cmd/aicommit@main

Or, download a binary from the latest release.

Usage

You can run aicommit with no arguments to generate a commit message for the staged changes.

export OPENAI_API_KEY="..."
aicommit

You can "retry" a commit message by using the -a/--amend flag.

aicommit -a

You can dry-run with -d/--dry to see the ideal message without committing.

aicommit -d

Or, you can point to a specific ref:

aicommit HEAD~3

You can also provide context to the AI to help it generate a better commit message:

aicommit -c "closes #123"
aicommit -c "improved HTTP performance by 50%"
aicommit -c "bad code but need for urgent customer fix"

When tired of setting environment variables, you can save your key to disk:

export OPENAI_API_KEY="..."
aicommit --save-key
# The environment variable will override the saved key.

Style Guide

aicommit will read the COMMITS.md file in the root of the repository to determine the style guide. It is optional, but if it exists, it will be followed even if the rules there diverge from the norm.

If there is no repo style guide, aicommit will look for a user style guide in ~/COMMITS.md.

Other Providers

You may set OPENAI_BASE_URL to use other OpenAI compatible APIs with aicommit. So far, I've tested it with LiteLLM across local models (via ollama) and Anthropic. I have yet to find a local model that is well-steered by the prompt design here, but the Anthropic Claude 3.5 commit messages are on par with 4o. My theory for why local models don't work well is they (incl. "Instruct" models) have much worse instruction fine-tuning than flagship commercial models.

About

become the world's laziest committer

Topics

Resources

Code of conduct

Security policy

Stars

184 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages