ORCommit

$3

> 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

---

TL;DR

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.

---

✨ Key Features

$3

* OpenAI (GPT‑4, GPT‑3.5)
* Claude via OpenRouter (200+ models)
* Local models via Ollama (offline & private)

$3

* Token-aware diff chunking (large repos supported)
* Interactive regeneration with feedback
* Custom prompts & project context
* Conventional Commits by default

$3

* Secret scanning via Gitleaks (100+ patterns)
* Blocks API keys, tokens, private keys
* Prevents committing node_modules/, vendor/, etc.
* Secure API key storage (600 permissions)

$3

* Breaking change detection
* Optional push after commit
* Git hooks support

$3

* Memory + disk cache
* Parallel API calls
* Strict TypeScript + comprehensive tests

---

🚀 Quick Start

`bash
npm install -g orcommit
orc config set openrouter YOUR_API_KEY

git add .
orc commit
`

That’s it.

---

🛠 Common Commands

`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
`

👉 Full CLI reference

---

🔐 Security Highlights

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.

👉 Security details

---

💡 Who Is ORCommit For?

* Teams — enforce commit standards automatically
* Open Source — keep contribution quality high
* Enterprise — prevent leaks and ensure compliance

---

⚙️ Configuration

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"
``

---

📚 Documentation

* CLI Reference
* Security Model
* Architecture
* Advanced Usage

---

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Add tests
4. Submit a pull request

---

🏢 About the Maintainers

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.

---

📄 License

MIT License — see LICENSE.

---

Built with ❤️ using TypeScript and modern AI tooling.