gitdevflow

gitdevflow is a modern, developer-friendly CLI tool for automating Git-based development workflows, Conventional Commit validation, PR management, and automated changelog generation.

Key Features

• 🐙 Pull Request Management — Create, list, check Conventional Commits, auto-label, and merge pull requests directly from your terminal.
• 📜 Changelog Generation — Automatically generate structured release notes in Markdown or JSON from git tag/commit comparisons and merged PRs.
• 🎨 Rich Terminal UX — Beautiful, colored terminal output, interactive setup wizards, progress bars, and Markdown previews using Rich.
• ⚙️ Flexible Configuration — Layered 12-factor configuration via YAML (~/.gitdevflow.yaml) and environment variable overrides (GITHUB_TOKEN).
• 🤖 Commit Compliance — Enforce Conventional Commit title and branch naming conventions for CI pipelines.

Installation

Using pip

pip install gitdevflow

Direct PyPI package link: https://pypi.org/project/gitdevflow/

Using pipx (Recommended for CLI tools)

pipx install gitdevflow

From Source

git clone https://github.com/BlockForge-Dev/gitdevflow.git
cd gitdevflow
poetry install

Quick Start

1. Initialize Configuration

export GITHUB_TOKEN="ghp_your_github_personal_access_token"
gitdevflow config init

2. PR Management

# List open PRs as a styled Rich table
gitdevflow pr list --repo owner/repository

# Check PR title compliance against Conventional Commits
gitdevflow pr check --repo owner/repository

# Automatically auto-label PRs based on branch/title prefix rules
gitdevflow pr label --repo owner/repository

# Create a new PR interactively
gitdevflow pr create --repo owner/repository --base main

3. Changelog Generation

# Generate Markdown changelog between tags
gitdevflow changelog generate --from-ref v0.1.0 --to-ref HEAD --output CHANGELOG.md

# Export changelog as structured JSON
gitdevflow changelog generate --from-ref v0.1.0 --output - --format json

Documentation

Full documentation is available at https://BlockForge-Dev.github.io/gitdevflow/.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details on setting up your environment and submitting pull requests.

License

Licensed under the MIT License.