git-ca 0.1.2

git plugin that drafts commit messages using GitHub Copilot
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

.TH GIT-CA 1 "2026-04-29" "git-ca 0.1.2" "User Commands"
.SH NAME
git-ca \- draft git commit messages with GitHub Copilot
.SH SYNOPSIS
.B git ca
.RI [ OPTIONS ]
.RI [ COMMAND ]
.br
.B git-ca
.RI [ OPTIONS ]
.RI [ COMMAND ]
.SH DESCRIPTION
.B git-ca
is a Git subcommand that drafts commit messages for staged changes using
GitHub Copilot. It reads the staged diff, asks Copilot for a Conventional
Commits message, writes the draft to Git's commit message file, and runs
.BR git-commit (1).
.PP
Git handles
.B git ca \--help
by opening this manual page. For clap-generated command help, use
.B git ca \-h
or
.BR "git-ca \--help" .
.SH OPTIONS
.TP
.BR \-n , " \--no-verify"
Skip pre-commit and commit-msg hooks.
.TP
.BI "\-m, \--model " MODEL
Use a specific Copilot model for drafting. This overrides the persisted default
model.
.TP
.BR \-y , " \--yes" , " \--auto-accept"
Commit the generated message without opening the editor.
.TP
.BR \-h , " \--help"
Print command help when the binary is invoked directly or through
.BR "git ca \-h" .
.TP
.BR \-V , " \--version"
Print version information.
.SH COMMANDS
.TP
.BI "auth login [" ACCOUNT "]"
Log in with GitHub device flow. When ACCOUNT is provided, store credentials
for that named account and make it active.
.TP
.BI "auth set-token [--account " ACCOUNT "] " TOKEN
Store a GitHub token manually and make that account active. If ACCOUNT is not
provided, the token is stored under the default account.
.TP
.BI "auth use " ACCOUNT
Select the named account for Copilot-backed commands.
.TP
.BI "auth logout [" ACCOUNT "]"
Delete locally stored tokens. When ACCOUNT is provided, only that named account
is removed.
.TP
.B auth status
Show local auth state, active account, stored account names, and cached Copilot
token TTL.
.TP
.B models
List Copilot chat models available to the authenticated account.
.TP
.B config list
Print all persisted config values.
.TP
.BI "config set-model " MODEL
Persist the default Copilot model.
.TP
.B config get-model
Print the persisted default model, if any.
.TP
.BI "config set-auto-accept " true|false
Persist whether generated messages commit without opening the editor.
.TP
.B config get-auto-accept
Print the persisted auto-accept setting.
.SH EXAMPLES
.TP
Draft a commit message and open the editor:
.B git ca
.TP
Draft with a specific model:
.B git ca \-m gpt-4o
.TP
Commit the generated message directly:
.B git ca \--yes
.TP
Show clap-generated help instead of this manual page:
.B git ca \-h
.SH FILES
.TP
.I ~/.config/git-ca/config.json
User preferences, including default model and auto-accept behavior.
.TP
.I ~/.config/git-ca/auth.json
Local GitHub and Copilot token cache.
.SH SEE ALSO
.BR git (1),
.BR git-commit (1)