1GIT-STANDUP(1) Git Extras GIT-STANDUP(1)
2
3
4
6 git-standup - Recall the commit history
7
9 git-standup [-a author] [-w weekstart-weekend|-d days-ago] [-m depth]
10 [-D date format] [-L] [-f] [-B] [-n number of commits] [-F gpg|author‐
11 date]
12 git-standup -h
13
15 Recall what you did on the last working day ..or be nosy and find what
16 someone else did.
17
19 -a author
20
21 The author of commits. Use "all" means specifying "all authors". De‐
22 faults to $(git config user.name).
23
24 -m depth
25
26 The depth of recursive directory search. Defaults to 1.
27
28 -L
29
30 Enable the inclusion of symbolic links in recursive directory search.
31
32 -d days-ago
33
34 The start of commit history. Defaults to 1, means "1 days ago".
35
36 -w weekstart-weekend
37
38 Limit the search range to weekdays. If weekstart and/or weekend are
39 missing they default to Mon and Fri. If the current day is weekstart,
40 commits made on weekend will be included. I.e. calling git standup -w -
41 on a Monday will include commits made on the last Friday.
42
43 -D relative
44
45 The date format displayed in commit history. Defaults to "relative".
46
47 -h
48
49 Display help message.
50
51 -f
52
53 Fetch the latest commits before showing commit history.
54
55 The former version of git standup accepted <author> <since> <until> as
56 options. This interface is deprecated now, and please avoid to use it!
57
58 -B
59
60 Display the commits in branch groups.
61
62 -n number-of-commits
63
64 Limit the number of commits displayed per group. By default, the limi‐
65 tation is applied in the repository level. For example, if you have 3
66 repositories under the current directory, git standup ... -n 1 will
67 show you 3 commits at most. When -B is specific, the limitation is ap‐
68 plied in the branch level. For instance, if each of your 3 repositories
69 have 2 branches, git standup ... -B -n 1 will display 6 commits at
70 most.
71
72 -F gpg|authordate
73
74 Change how the commits are formatted. Takes an argument, can be speci‐
75 fied multiple times.
76
77 ○ -F gpg: Display if commit is GPG signed (G) or not (N).
78
79 ○ -F authordate: Print the author date instead of the commit date.
80
81
82
84 You can configure a implicit -w weekstart-weekend, which is superseded
85 if -w or -d is given on the command line. Note that the weekstart-week‐
86 end must be specified, they don´t have any default values as the -w
87 flag has.
88
89
90 $ git config --global git-extras.standup.implicit-week "Mon-Fri"
91
92
93
95 This shows your commits since yesterday:
96
97
98 $ git standup
99
100 a26d1f9 - add profile hook (69 minutes ago) <spacewander>
101
102
103
104 This shows the author´s commits since last week:
105
106
107 $ git standup -a spacewander -d 7
108
109 a26d1f9 - add profile hook (70 minutes ago) <spacewander>
110 4e19859 - fix getTotalSize return value error (6 days ago) <spacewander>
111 36da84e - fix rename over bound (7 days ago) <spacewander>
112 8e4182a - add watermark.png (7 days ago) <spacewander>
113 46fef1d - use tinyXML to configure (7 days ago) <spacewander>
114
115
116
117 If current directory is not a git repo, git-standup will fetch data
118 from all top-level git repos under it:
119
120
121 $ cd ..
122 $ git standup -a spacewander -d 7
123
124 someProject/
125 4e19859 - fix getTotalSize return value error (6 days ago) <spacewander>
126 36da84e - fix rename over bound (7 days ago) <spacewander>
127 8e4182a - add watermark.png (7 days ago) <spacewander>
128 46fef1d - use tinyXML to configure (7 days ago) <spacewander>
129
130
131
132 By specifying the -B option, git-standuo will group the commits in
133 branches:
134
135
136 $ git standup -B -a spacewander -d 7
137
138 git-summary-cleanup
139 f788c78 - git-summary: clean up other shellcheck warnings (23 hours ago) <spacewander>
140 3e8c3ab - git-summary: fix incorrect active days when commits range is given (23 hours ago) <spacewander>
141 ff991ac - git-summary: remove useless result function. (23 hours ago) <spacewander>
142 203f5b4 - git-summary: add --dedup-by-email to remove duplicate users (5 days ago) <spacewander>
143
144 master
145 203f5b4 - git-summary: add --dedup-by-email to remove duplicate users (5 days ago) <spacewander>
146
147
148
149 Note that the same commit can be seen in different branches.
150
152 Originally from https://github.com/kamranahmedse/git-standup
153
155 <https://github.com/tj/git-extras/issues>
156
158 <https://github.com/tj/git-extras>
159
160
161
162 July 2022 GIT-STANDUP(1)