g-check

Blazing-fast CLI tool that analyzes Git repositories and provides actionable diagnostics.

What it detects

| Issue | Description | |-------|-------------| | 🔴 Inactivity | Gaps >7 days between commits | | 🟡 Author dominance | One person made >70% of commits | | 🟡 Stale branches | Branches inactive for >30 days | | 🟡 Low bus factor | Files with single author and high commit count |

Quick Start

# Install
npm install -g @jara505/g-check

# Run (current directory)
g-check
g-check --path /my/repo
g-check -p /my/repo
g-check -p /my/repo --min-commits 5   # active file threshold (default: 3)

Example Output

g-check diagnostic report
────────────────────────────────────────

  CRITICAL  Detected 56 days of inactivity between commits.
  ↳ Encourage smaller, more frequent commits to reduce integration risk.

  WARNING   "jara505" authored 81% of commits (71/88).
  ↳ Distribute work more evenly to avoid bus factor risk.

────────────────────────────────────────
2 issue(s) found.

Documentation

For API reference and advanced usage, see docs/README.md.

Requirements

• Node.js 20.18+
• Git installed

License

Proprietary. See LICENSE for details.