Commit Wizard Documentation

Commit Wizard (cw) is a lightweight CLI tool that helps teams enforce Conventional Commits, manage Semantic Versioning, and automate changelog generation.

Commit Wizard should feel like β€œa spellbook for your commits” β€” simple recipes, powerful results.

It guides developers like an experienced mentor, ensures consistency for teams, and gives CI/CD pipelines strict, reproducible enforcement.

Commit Wizard Mascot

πŸ”‘ Design Philosophy

Commit Wizard is built around a few core principles:

  • Guided, not restrictive β†’ help developers without blocking them
  • Simple mental model β†’ one config at a time, explicit overrides
  • Portable & reliable β†’ works the same on Linux, macOS, Windows, Docker/Podman
  • CI-friendly β†’ interactive for devs, strict for automation
  • Conventional Commits first β†’ feat and fix always enforced by default; teams can extend

πŸ“¦ Project Resources