README.md

 1<!--
 2SPDX-FileCopyrightText: Amolith <amolith@secluded.site>
 3
 4SPDX-License-Identifier: CC0-1.0
 5-->
 6
 7```
 8$ formatted-commit -h
 9
10  formatted-commit helps you create well-formatted Git commits that follow
11  the Conventional Commits specification with proper subject length validation,
12  body wrapping, and trailer formatting.
13
14  USAGE
15
16
17    formatted-commit [--flags]
18
19
20  EXAMPLES
21
22
23    # With co-author
24    formatted-commit -t feat -m "do a thing" -t "Crush <crush@charm.land>"
25
26    # Breaking change with longer body
27    formatted-commit -t feat -m "do a thing that borks a thing" -B "$(cat <<'EOF'
28    Multi-line
29    - Body
30    - Here
31
32    This is what borked because of new shiny, this is how migrate
33    EOF
34    )"
35
36    # Including scope for more precise changes
37    formatted-commit -t refactor -s "web/git-bug" -m "fancy shmancy" \
38      -b "Had to do a weird thing because..."
39
40
41  COMMANDS
42
43    help [command]  Help about any command
44
45  FLAGS
46
47    -b --body       Commit body (optional)
48    -B --breaking   Mark as breaking change (optional)
49    -h --help       Help for formatted-commit
50    -m --message    Commit message (required)
51    -s --scope      Commit scope (optional)
52    -T --trailer    Trailer in 'Sentence-case-key: value' format (optional, repeatable)
53    -t --type       Commit type (required)
54    -v --version    Version for formatted-commit
55```