AI-powered commit message generator - Automated git commits using OpenAI, Claude, and OpenRouter APIs with intelligent diff processing, custom prompts, and interactive regeneration
npm install orcommit

> Generate accurate, conventional, and secure git commit messages using OpenAI, Claude, OpenRouter, or local models (Ollama).
``bash`
git add .
orc commit
✔ Conventional Commits
✔ Secret scanning (Gitleaks)
✔ Cloud & local AI
✔ Zero-config to start
---
ORCommit is a production-grade CLI that:
* analyzes your staged git diff
* generates a high-quality commit message via LLMs
* enforces Conventional Commits
* blocks secrets and dependency folders before commit
* works with both cloud and local AI models
If you care about clean history, security, and standards — this tool is for you.
---
* OpenAI (GPT‑4, GPT‑3.5)
* Claude via OpenRouter (200+ models)
* Local models via Ollama (offline & private)
* Token-aware diff chunking (large repos supported)
* Interactive regeneration with feedback
* Custom prompts & project context
* Conventional Commits by default
* Secret scanning via Gitleaks (100+ patterns)
* Blocks API keys, tokens, private keys
* Prevents committing node_modules/, vendor/, etc.
* Secure API key storage (600 permissions)
* Breaking change detection
* Optional push after commit
* Git hooks support
* Memory + disk cache
* Parallel API calls
* Strict TypeScript + comprehensive tests
---
`bash
npm install -g orcommit
orc config set openrouter YOUR_API_KEY
git add .
orc commit
`
That’s it.
---
`bash`
orc commit # interactive commit
orc commit --yes # auto-confirm
orc commit --context "..." # extra context
orc commit --emoji # gitmoji
orc commit --breaking # breaking change
orc commit --dry-run # preview only
---
ORCommit includes mandatory security checks:
* 🔍 Secret scanning via Gitleaks
* 🚫 Blocks API keys, tokens, private keys
* 🚫 Prevents committing dependency folders
These checks run before commit creation and cannot be bypassed accidentally.
---
* Teams — enforce commit standards automatically
* Open Source — keep contribution quality high
* Enterprise — prevent leaks and ensure compliance
---
Config is stored at ~/.config/orcommit.json (permissions 600).
`json`
{
"preferences": {
"defaultProvider": "openrouter",
"commitFormat": "conventional",
"temperature": 0.6
}
}
Environment variables are also supported:
`bash``
export OPENROUTER_API_KEY="your-key"
export OPENAI_API_KEY="your-key"
---
* CLI Reference
* Security Model
* Architecture
* Advanced Usage
---
1. Fork the repository
2. Create a feature branch
3. Add tests
4. Submit a pull request
---
ORCommit is built and maintained by Reforms.ai — a team specializing in AI-powered developer tools.
Commercial support, consulting, and custom AI integrations are available.
---
MIT License — see LICENSE.
---
Built with ❤️ using TypeScript and modern AI tooling.