dotnet-gitmoji 0.2.0

dotnet-gitmoji

Write expressive, emoji-prefixed commit messages in .NET projects — automatically via a Git hook, or interactively from the terminal.

dotnet-gitmoji brings the gitmoji commit convention to your .NET workflow. Pick an emoji, type your message, and commit — the tool handles the format. It works either as a Git hook that intercepts every git commit, or as a standalone command that replaces git commit.

Features

• 🪝 Git hook mode — installs a prepare-commit-msg hook that activates on every commit
• 💻 Client mode — use dotnet-gitmoji commit as a drop-in for git commit
• 🔍 Fuzzy search — find the right emoji by name, code, or description
• ⚙️ Flexible config — per-repo .gitmojirc.json or a personal global fallback
• 🤝 Husky.Net support — integrates with both shell and task-runner setups
• 📦 Local & global install — generates the correct hook command for either setup

Requirements

• .NET 10 SDK or later

Installation

Global

dotnet tool install --global dotnet-gitmoji

Use dotnet-gitmoji <command> directly anywhere in your terminal.

Local (per project)

dotnet new tool-manifest   # skip if .config/dotnet-tools.json already exists
dotnet tool install dotnet-gitmoji

dotnet tool run dotnet-gitmoji init
dotnet tool run dotnet-gitmoji commit

Quick Start

Install the Git hook and start committing with gitmoji in three steps:

# 1. Install the hook
dotnet-gitmoji init

# 2. Commit as usual — the hook activates automatically
git commit

# 3. Pick your emoji, confirm the message, done ✓

To remove the hook at any time:

dotnet-gitmoji remove

Usage

Hook Mode (recommended)

Hook mode installs a prepare-commit-msg hook that runs every time you call git commit. The tool prompts you to pick a gitmoji, and any commit message you passed (via -m or your editor) is pre-filled as the title suggestion.

dotnet-gitmoji init

After that, just commit normally:

git commit
git commit -m "fix login redirect"   # message pre-filled as title

Client Mode

dotnet-gitmoji commit works as a drop-in replacement for git commit when you prefer not to use the hook.

dotnet-gitmoji commit
dotnet-gitmoji commit --title "fix login redirect"
dotnet-gitmoji commit --title "fix login redirect" --scope auth --message "Resolves #42"

Husky.Net Integration

Already using Husky.Net? Pass --mode to init and dotnet-gitmoji will integrate with your existing Husky setup instead of creating a standalone hook.

Shell mode

Appends the gitmoji invocation to your .husky/prepare-commit-msg file:

dotnet-gitmoji init --mode shell

Task-runner mode

Adds a dotnet-gitmoji task to .husky/task-runner.json and registers the hook:

dotnet-gitmoji init --mode task-runner

dotnet-gitmoji init --mode shell --config

Configuration

Interactive wizard

The quickest way to configure preferences — walks through every option and saves to the global config:

dotnet-gitmoji config

Manual configuration

Create a .gitmojirc.json in your repo root, or generate one with defaults:

dotnet-gitmoji init --config

Example file:

{
  "emojiFormat": "Emoji",
  "scopePrompt": false,
  "messagePrompt": false,
  "capitalizeTitle": true,
  "gitmojisUrl": "https://gitmoji.dev/api/gitmojis",
  "autoAdd": false,
  "signedCommit": false,
  "scopes": null
}

Configuration reference

Config resolution order

The tool looks for configuration in this order, using the first match:

Commands

License

MIT — Jonathan Búcaro