@nevaberry/opencodecommit 1.0.2 → 1.1.0

package/README.md

@@ -5,13 +5,13 @@ AI commit messages via terminal AI agents. VSCodium / VS Code extension + standa
 **Security scanning built in** — diffs are scanned locally for secrets, source maps, and private keys before anything leaves your machine.
 
 [VSCodium Open VSX registry](https://open-vsx.org/extension/Nevaberry/opencodecommit)<br>
-[VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Nevaberry.opencodecommit) · [npm](https://www.npmjs.com/package/@nevaberry/opencodecommit) · [crates.io](https://crates.io/crates/opencodecommit) · [GitHub](https://github.com/Nevaberry/opencodecommit)
+[VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Nevaberry.opencodecommit) · [npm](https://www.npmjs.com/package/opencodecommit) · [scoped npm](https://www.npmjs.com/package/@nevaberry/opencodecommit) · [crates.io](https://crates.io/crates/opencodecommit) · [GitHub](https://github.com/Nevaberry/opencodecommit)
 
 ## Install
 
 **Extension:** Search "OpenCodeCommit" in VSCodium / VS Code, or `ext install Nevaberry.opencodecommit`
 
-**CLI:** `cargo install opencodecommit` or `npm i -g @nevaberry/opencodecommit` (installs `occ` command)
+**CLI:** `cargo install opencodecommit` or `npm i -g opencodecommit` (official unscoped alias: `@nevaberry/opencodecommit`)
 
 **Prerequisite:** At least one CLI backend:
 
@@ -33,6 +33,7 @@ Dropdown menu: mode-specific generation, refine, branch name generation, switch
 ## CLI Usage
 
 ```bash
+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
@@ -46,13 +47,32 @@ 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:
+
+```bash
+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. The CLI blocks (exit 5) and the extension shows a warning dialog.
+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:
+
+```bash
+OCC_ALLOW_SENSITIVE=1 git commit ...
+```
 
 **Flagged file names:**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nevaberry/opencodecommit",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "AI-powered git commit message generator that delegates to terminal AI agents",
   "license": "MIT",
   "repository": {