Recall what you did on the last working day ..or be nosy and find what someone else did.
A little tool that I always wanted for myself. I work on several repositories on daily basis and it is mostly difficult for me to remember where I left off in each one of them. git-standup helps me with running standups and keeping track of what I have been doing. By default it gives you the most common usage i.e. shows you commits from the last working day in the current directory and the directories below current level plus it comes with several options to modify how it behaves.
The only requirement is having good commit messages :)
You can install git-standup using one of the options listed below
| Source | Command |
|---|---|
| curl | curl -L https://github.com/kamranahmedse/git-standup/master/installer.sh | sudo sh |
| npm | npm install -g git-standup |
| brew | brew update && brew install git-standup |
| aur | pacaur -S git-standup-git |
| manual | Clone and run make install |
Simply run it in your project directory and it will give you the output from the last working day
git standupIf you run it in a folder containing multiple git repositories, it will go through each of the projects and give you the standup report for each one of them.
You can pass several options to modify how git-standup behaves
git standup [-a <author name>]
[-w <weekstart-weekend>]
[-m <max-dir-depth>]
[-F]
[-b <branch-to-use>]
[-d <since-days-ago>]
[-u <until-days-ago>]
[-D <date-format>]
[-A <after-date>]
[-B <before-date>]
[-L]
[-g]
[-h]
[-f]
[-s]
[-r]
[-c]
[-R]Here is the detail for each of the options
| Option | Description |
|---|---|
| a | Specify author to restrict search to e.g. -a "Kamran Ahmed" or -a "all" |
| b | Specify branch to restrict search to (unset: all branches, "$remote/$branch" to include fetches) |
| w | Specify week start and end days e.g. in UAE weekdays are from Sunday to Thursday so you can do -w SUN-THU |
| m | Specify the depth of recursive directory search e.g. -m 3 defaults to two |
| F | Force recursion up to specified depth even when git repository found earlier |
| d | Specify the number of days back to include e.g. -d 30 to get for a month |
| u | Specify the number of days back till which standup should run e.g. -u 3 |
| L | Toggle inclusion of symbolic links in recursive directory search |
| D | Specify the date format for "git log" (default: relative) possible values |
| A | Show the commits till after the given date |
| B | Show the commits till before the given date |
| h | Display the help screen |
| g | Show if commit is GPG signed (G) or not (N) |
| f | Fetch the latest commits beforehand |
| s | Silences the no activity message (useful when running in a directory having many repositories) |
| c | Show diff-stat for every matched commit |
| r | Generates the standup report file git-standup-report.txt in the current directory |
| R | Display the author date instead of the committer date |
For the basic usage, all you have to do is run git standup in a repository or a folder containing multiple repositories
To check all your personal commits from last working day, head to the project repository and run
$ git standup
Open a directory having multiple repositories and run