GitForge

Practical Git workflow automation for branches, snapshots, releases, and repository hygiene.

GitForge is a terminal-first Git workflow assistant for developers who want repeatable branch naming, safer commits, fast repository health checks, release tags, changelogs, branch cleanup, and ref comparisons without memorizing a pile of shell snippets. It uses the real Git executable, prints clean Rich tables, and keeps every operation explicit so it fits normal local and CI workflows.

• Repository health checks - inspect branch, upstream, dirty state, remotes, conflicts, and local Git identity.
• Branch automation - turn ticket titles into consistent branch names and optionally switch to them.
• Snapshot commits - stage tracked or all files, commit with guardrails, and optionally push.
• Release tagging - create annotated semantic-version tags with dirty-tree protection.
• Changelog generation - group commit history into Markdown or JSON output.
• Cleanup and compare tools - remove merged branches safely and summarize ref differences.

Installation

pip install gitforge-cli

The installed console command is:

gitforge --help

Usage

Inspect a repository:

gitforge status --repo .
gitforge doctor --repo .

Create a workflow branch:

gitforge branch "Add OAuth callback validation" --ticket AUTH-42 --prefix feature

Commit a snapshot:

gitforge snapshot -m "Implement OAuth callback validation"

Generate a changelog:

gitforge changelog --since v0.1.0 --output CHANGELOG.md

Create a release tag:

gitforge release 1.2.0 --push

Commands

Configuration

GitForge intentionally uses standard Git configuration instead of its own config file.

git config user.name "Your Name"
git config user.email "you@example.com"
git remote add origin git@github.com:you/project.git
git branch --set-upstream-to origin/main main

Most commands accept --repo so they can operate on another checkout without changing directories.

License

MIT License. See LICENSE.