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

Stage changes (or leave unstaged — auto-detected)
Click the sparkle button in Source Control
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

opencodecommit 1.1.4