id          = "git-mob"
name        = "git-mob"
homepage    = "https://github.com/rkotze/git-mob"
description = "CLI tool for including co-authors in commits"
executables      = ["git-mob", "git-mob-print"]

[dotfiles]

# The upstream README identifies the global co-author database as ~/.git-coauthors;
# repository-local .git-coauthors files are intentionally not user dotfiles.
# https://github.com/rkotze/git-mob#path-to-git-coauthors
paths = ["~/.git-coauthors"]
secret = []
side_effect = false

[commands]
format = 1
label = "Set co-authors"
description = "Choose the co-authors for the next commits from the initials in your .git-coauthors file, or list them. Adding and suggesting co-authors use separate commands and are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "help"
url = "https://github.com/rkotze/git-mob/blob/master/packages/git-mob/README.md"
revision = "master 2026-10-27"
evidence = """
$ git mob ad bd
$ git mob --list
Overwrite the current author which could be useful for pairing on different machines
$ git mob -o jd ad
Print out path to `.git-coauthors` file.
git mob -p
"""

[[commands.field]]
id = "initials"
label = "Co-author initials"
description = "Initials from your .git-coauthors file, in order."
type = "string"
position = 0
multiple = true
sources = ["readme"]

[[commands.field]]
id = "override_author"
label = "Overwrite main author with first initials"
type = "boolean"
option = ["-o"]
sources = ["readme"]

[[commands.field]]
id = "list"
label = "List available co-authors"
type = "boolean"
option = ["--list"]
sources = ["readme"]

[[commands.field]]
id = "path"
label = "Print .git-coauthors path"
type = "boolean"
option = ["-p"]
sources = ["readme"]

[[commands.task]]
id = "pair"
label = "Start pairing"
fields = ["initials"]
required = ["initials"]

[[commands.task]]
id = "list"
label = "List co-authors"
fields = ["list"]
required = ["list"]
set = { list = [true] }
lock = ["list"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["initials", "override_author", "list", "path"]