gitremind

A small developer CLI that scans a git repository and flags commits whose message body (or metadata) has drifted from the current branch tip's file set.

gitremind helps catch stale commits, dangling unmerged branches, and large file changes well before CI does. It produces a compact report and emits machine-readable JSON for automation.

About

In long-running repositories, it's easy to forget that a commit landed on a feature branch, or that the branch tip no longer reflects the files that changed in its last few commits. gitremind inspects the current branch, compares each recent commit against the branch tip's tree, and reports high-risk commits:

• commits whose changed files are no longer present in the current tip,
• branches that appear to have diverged from the tracked upstream,
• the five largest files in the most recent non-merge commit on the current branch.

There are no network calls. There are no external services. gitremind works entirely from local git history.

Features

• Fast local scan using stdlib subprocess and json.
• Flags commits whose file changes no longer exist in the branch tip tree.
• Optional upstream-diff summary against a local tracking branch.
• Emits <sha> sized analysis on the most recent non-merge commit on the current branch.
• JSON output for CI and automation.
• Exit code semantics: success, tooling error, or actionable risk found (3).

Installation

python -m pip install -e .

After installing, gitremind is on your PATH.

gitremind .
gitremind --json . --upstream main --limit 10

Source and issues: https://github.com/Axelgustavlindstrom/gitremind

Usage

Scan the current working directory:

gitremind .

Request JSON output and compare the current branch against main:

gitremind --json . --upstream main --limit 10

Options

• path — repository path to scan, default .
• -n / --limit — maximum commits to inspect, default 10
• --upstream — upstream branch to diff against
• --json — emit structured JSON
• -q / --quiet — only print risk findings

Project structure

gitremind/
  gitremind/
    __init__.py
    cli.py
    scanner.py
  tests/
    test_scanner.py
    test_cli.py
  pyproject.toml
  README.md

Tags

python, cli, git, developer-tools, git-audit, automation

License

MIT