opencodecommit 1.1.1

AI-powered git commit message generator that delegates to terminal AI agents
Documentation

OpenCodeCommit

AI commit messages via terminal AI agents. VSCodium / VS Code extension + standalone Rust / npm CLI.

Security scanning built in — diffs are scanned locally for secrets, source maps, and private keys before anything leaves your machine.

VSCodium Open VSX registry VS Code Marketplace · npm · scoped npm · crates.io · GitHub

Install

Extension: Search "OpenCodeCommit" in VSCodium / VS Code, or ext install Nevaberry.opencodecommit

CLI: cargo install opencodecommit or npm i -g opencodecommit (official unscoped alias: @nevaberry/opencodecommit)

Prerequisite: At least one CLI backend:

Backend Install
Codex CLI npm i -g @openai/codex
OpenCode npm i -g opencode
Gemini CLI npm i -g @google/gemini-cli
Claude Code npm i -g @anthropic-ai/claude-code

VSCodium / VS Code Usage

  1. Stage changes (or leave unstaged — auto-detected)
  2. Click the sparkle button in Source Control
  3. Commit message appears in the input box

Dropdown menu: mode-specific generation, refine, branch name generation, switch language, diagnose.

CLI Usage

occ tui                            # launch the minimal interactive TUI
occ commit                         # generate message + commit
occ commit --dry-run               # preview only, don't commit
occ commit --language Suomi        # generate in Finnish
occ branch                         # generate branch name + checkout
occ branch --mode adaptive         # match existing branch naming style
occ pr                             # generate PR title + body
occ changelog                      # generate changelog entry

# JSON output (default), or --text for human readable plain text
occ commit --text
occ commit --allow-sensitive       # skip secret scanning

occ tui is a small launcher over the existing commands, not a full git dashboard. It lets you generate, shorten, and commit messages, plus preview branch / PR / changelog output from one screen.

occ is the short form. opencodecommit also works if occ clashes with something on your system.

Exit codes: 0 success, 1 no changes, 2 backend error, 3 config error, 5 sensitive content detected

Transparent Git Guard

Use OpenCodeCommit as a background safety layer for normal git commit usage:

occ guard install --global         # install a machine-wide commit guard
occ guard uninstall --global       # remove the machine-wide guard

This installs a managed global hooks directory via core.hooksPath. pre-commit scans the staged diff for sensitive content, and other hook names are chained through so existing repo hooks still run.

Sensitive Content Detection

Diffs are scanned locally before being sent to any AI backend. occ commit blocks with exit code 5, and the global guard blocks normal git commit before the commit is created.

Guard warnings include the file, line number when available, rule, and a redacted snippet preview. If a hook-mode block is an intentional false positive, bypass only OpenCodeCommit for that one command:

OCC_ALLOW_SENSITIVE=1 git commit ...

Flagged file names:

Category Patterns
Environment / secrets .env*, credentials.json, secret.*, secrets.*, .netrc, service-account*.json
Source maps *.js.map, *.css.map, *.map — can expose full source code
Private keys / certs *.pem, *.key, *.p12, *.pfx, *.keystore, *.jks
SSH keys id_rsa, id_ed25519, id_ecdsa, id_dsa, .ssh/*
Auth files .htpasswd
Category Patterns
Generic secrets API_KEY, SECRET_KEY, ACCESS_TOKEN, AUTH_TOKEN, PRIVATE_KEY, PASSWORD, DB_PASSWORD, DATABASE_URL, CLIENT_SECRET, CREDENTIALS
Service-specific AWS_SECRET, GH_TOKEN, NPM_TOKEN, SLACK_TOKEN, STRIPE_SECRET, SENDGRID_KEY, TWILIO_AUTH
Token patterns Bearer <20+ chars>, sk-<20+ chars>, ghp_<20+ chars>, AKIA<12+ chars>

Configuration

All VSCodium / VS Code settings are prefixed with opencodecommit.. Key settings:

Setting Default Description
backendOrder ["codex","opencode","claude","gemini"] Backend fallback order
commitMode adaptive adaptive, adaptive-oneliner, conventional, conventional-oneliner
branchMode conventional conventional or adaptive (matches existing branch names)
diffSource auto auto, staged, or all
languages English, Suomi Array of language configs with custom prompt modules
commitTemplate {{type}}: {{message}} Supports {{type}}, {{emoji}}, {{message}}

CLI config: ~/.config/opencodecommit/config.toml (TOML with the same fields in kebab-case).

Languages

Built-in: English (default), Suomi (Finnish), Custom (example) (template for your own).

Each language defines full prompt modules (base, adaptive, conventional, length, sensitive note). Missing modules fall back to English. CLI: --language Suomi. Extension: dropdown menu or opencodecommit.activeLanguage setting.

Add custom languages in config — only label and instruction are required:

[[languages]]
label = "Deutsch"
instruction = "Schreibe die Commit-Nachricht auf Deutsch."

License

MIT