Codebase

Git Intelligence

Read your own patterns

npx promptreports-cli git-intel

Analyzes hotspot files, commit velocity, tech debt indicators, coding time patterns. Auto-generates changelogs.

git-intel turns your git history into self-awareness. Hotspots = which files change the most (likely architectural debt). Velocity = commits/day, active days, avg files/commit. Tech debt = files with the most "fix:" commits (bug nests). Patterns = when do you work best? Changelog = auto-generate for releases.

Prerequisites

Git repository with commits

Flags & Options

Flag	Description	Default
--days N	Lookback	7
--hotspots	Most-changed files	—
--velocity	Commits/day	—
--debt	Files with most fix: commits	—
--patterns	Time-of-day patterns	—
--changelog	Generate "- {msg}" changelog	—
--json	JSON output	—

Examples

Everything

npx promptreports-cli git-intel

All metrics, 7 days.

Debt check

npx promptreports-cli git-intel --debt --days 90

Quarterly tech debt review.

Release changelog

npx promptreports-cli git-intel --changelog --days 30

Paste into release notes.

Output

Sections: hotspots table, velocity metrics, debt files, patterns (peak hours, best day, fix:feature ratio), changelog.

  Hotspot Files (last 7 days)
  File                                      Changes
  app/api/auth/route.ts                    12
  lib/db/queries.ts                         8
  components/Dashboard.tsx                  7

  Velocity
  Total commits:       87
  Active days:         7/7
  Commits/day:         12.4
  Avg files/commit:    3.2

  Tech Debt Indicators
  app/api/checkout/route.ts   — 8 fix: commits
  lib/parsing.ts              — 6 fix: commits
  components/Form.tsx         — 5 fix: commits

  Coding Patterns
  Peak hours:          9:00, 14:00, 18:00
  Best day:            Wednesday (14 commits avg)
  Fix:feature ratio:   0.6:1  (healthy — target 0.5:1)

  Changelog
  - feat: add user preferences page
  - fix: resolve auth token expiry
  - chore: update dependencies
  - refactor: extract payment logic
  ... (87 entries total)

What it reads and writes

Reads

Git history

Writes

Nothing (read-only)

Free vs Pro usage

Free tier

Retro prep — data-driven what-went-well/what-didn't
Auto-changelog for releases
Identify which files need refactor love (hotspots + debt)

Pro tier

Upgrade

Team-wide velocity dashboard
Predictive: "this file is about to have a bug" based on churn
Auto-assign code reviewers based on historical ownership
Burn-down for tech debt initiatives

Pro tips

Hotspot + debt overlap = your highest-ROI refactor target
Fix:feature ratio > 1:1 means you're in maintenance mode
Best day insight is personal — schedule hard work for yours

Free to try

Install the whole toolkit.

One command unlocks all 23 tools.

Start Free Back to all tools