Skip to content

Cross-repo customizable Git activity log dotfile with CLI for viewing and filtering entries

License

Notifications You must be signed in to change notification settings

olets/git-activity

Repository files navigation

git-activity GitHub release (latest by date) GitHub commits since latest release

git-activity: Record your Git activity across multiple (or all) repos, and read it optionally filtered by date, activity type (e.g. commit, branch creation, etc) regex pattern, repo name regex pattern, branch name regex pattern, commit message regex pattern, and/or commit SHA (first seven characters) regex pattern.

It's sort of like a global git log where you control which repos are watched and what types of activity are recorded.

Useful for

  • retroactively filling out a time sheet, or correcting a time sheet when you realize you left one timer running all day

  • answering a weekly department "What projects did you work on last week and what did you do on them?" prompt

  • finding that time you solved a problem similar to the one you're working on now

The log is stored in a text file. You can run your own programs on it if the git-activity CLI doesn't meet your needs, and you can share it across your computers for a cross-repo cross-machine log.

Quick start

> brew install olets/tap/git-activity
# close the terminal
# open a new terminal
> git activity install --global # just once
# go about your day
> git activity show

And then read up on all the ways you can filter git activity show in the command's documentation.

 

Documentation

📖 https://git-activity.olets.dev/

 

Changelog

See the CHANGELOG file.

Contributing

Thanks for your interest. Contributions are welcome!

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Check the Issues to see if your topic has been discussed before or if it is being worked on.

Please read CONTRIBUTING.md before opening a pull request.

License

git-activity by Henry Bley-Vroman is, with the exception of its logo as covered below, licensed under a license which is the unmodified text of CC BY-NC-SA 4.0 and the unmodified text of a Hippocratic License 3. It is not affiliated with Creative Commons or the Organization for Ethical Source.

Human-readable summary of (and not a substitute for) the LICENSE file:

You are free to

  • Share — copy and redistribute the material in any medium or format
  • Adapt — remix, transform, and build upon the material

Under the following terms

  • Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
  • Non-commercial — You may not use the material for commercial purposes.
  • Ethics - You must abide by the ethical standards specified in the Hippocratic License 3 with Ecocide, Extractive Industries, US Tariff Act, Mass Surveillance, Military Activities, and Media modules.
  • Preserve terms — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.
  • No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.

Related

I've created other command line tools, including other Git tools. Check them out at https://olets.dev/software/.

About

Cross-repo customizable Git activity log dotfile with CLI for viewing and filtering entries

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks