Karls.Gitflow.Tool 0.0.2

Karls.Gitflow

A .NET 10 reimplementation of gitflow-avh, providing a modern command-line tool for managing Git branches using the Gitflow branching model.

Features

• Feature branches - Develop new features in isolation
• Bugfix branches - Fix bugs targeting the develop branch
• Release branches - Prepare releases with version bumps and final fixes
• Hotfix branches - Quick fixes for production issues
• Support branches - Long-term support for older versions

Supported Operations

Installation

dotnet tool install -g Karls.Gitflow.Tool

Usage

Initialize Gitflow

# Interactive initialization
git-flow init

# Use default settings
git-flow init -d

# Specify options
git-flow init --main main --develop develop

Feature Branches

# List all feature branches
git-flow feature list

# Start a new feature
git-flow feature start my-feature

# Finish a feature (merges to develop)
git-flow feature finish my-feature

# Publish feature to remote
git-flow feature publish my-feature

# Delete a feature branch
git-flow feature delete my-feature

Release Branches

# Start a release
git-flow release start 1.0.0

# Finish a release (merges to main AND develop, creates tag)
git-flow release finish 1.0.0 -m "Release 1.0.0"

# Publish release to remote
git-flow release publish 1.0.0

Hotfix Branches

# Start a hotfix from main
git-flow hotfix start 1.0.1

# Finish a hotfix (merges to main AND develop, creates tag)
git-flow hotfix finish 1.0.1 -m "Hotfix 1.0.1"

Configuration

# List current configuration
git-flow config list

# Set a configuration value
git-flow config set feature feat/

Branch Auto-Detection

When on a gitflow branch, you can omit the branch name for finish, publish, and delete commands:

# While on feature/my-feature branch
git-flow feature finish  # Automatically detects "my-feature"

Finish Options

Release/Hotfix Specific Options

Project Structure

src/
  Karls.Gitflow.Core/        # Core library with gitflow logic
  Karls.Gitflow.Tool/        # CLI application

test/
  Karls.Gitflow.Core.Tests/  # Unit tests for core library
  Karls.Gitflow.Tool.Tests/  # E2E tests for CLI
  Karls.Gitflow.TestHelpers/ # Shared test utilities

Building from Source

# Build
dotnet build

# Run tests
dotnet test

# Run the tool locally
dotnet run --project src/Karls.Gitflow.Tool -- init -d

Requirements

• .NET 10 SDK
• Git installed and available in PATH

License

MIT