{"id":16797128,"url":"https://github.com/jdockerty/today","last_synced_at":"2025-04-11T00:12:24.333Z","repository":{"id":44410997,"uuid":"512453043","full_name":"jdockerty/today","owner":"jdockerty","description":"View your commit history across multiple directories, ideal for daily standup.","archived":false,"fork":false,"pushed_at":"2022-07-28T13:49:21.000Z","size":30,"stargazers_count":23,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-11T00:12:12.231Z","etag":null,"topics":["cli","git","git-commit","go","golang","golang-cli","productivity","standup"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jdockerty.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-07-10T14:15:48.000Z","updated_at":"2025-03-27T15:44:24.000Z","dependencies_parsed_at":"2022-07-17T01:15:57.694Z","dependency_job_id":null,"html_url":"https://github.com/jdockerty/today","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdockerty%2Ftoday","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdockerty%2Ftoday/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdockerty%2Ftoday/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdockerty%2Ftoday/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jdockerty","download_url":"https://codeload.github.com/jdockerty/today/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248317729,"owners_count":21083530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","git","git-commit","go","golang","golang-cli","productivity","standup"],"created_at":"2024-10-13T09:21:12.910Z","updated_at":"2025-04-11T00:12:24.311Z","avatar_url":"https://github.com/jdockerty.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# today\n\n![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/jdockerty/today?color=blue)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/jdockerty/today?color=black)\n\nView your commit history across multiple directories, ideal for daily standup.\n\nEasily view the work that you have done for the day, or longer, leveraging the power of `git` tracking one or more repositories. This tool is simple to use and requires no extra setup, it simply utilises an pre-existing workflow that you are already familiar with.\n\nThis works best when paired with clear and concise commit messages. A great example of this is [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/#summary).\n\n## Install\n\nThe easiest way to install is through the `go` command.\n\n```bash\ngo install github.com/jdockerty/today@latest # or tag/ref: @v0.1.X, @HEAD, etc.\n```\n\nOr by downloading a pre-compiled binary on the [releases](https://github.com/jdockerty/today/releases) page.\n\n## Usage\n\nSimply pass one or more directories that you wish to view the commits for.\n\n```bash\ntoday ./ # View the current directory\n\ntoday work/api work/frontend work/new-important-serivce # You've been very busy\n\ntoday --since 48h work/api # You missed standup yesterday\n\ntoday --short work/fun-poc # Only display first line of the commit message\n\ntoday --author \"Jack\" projects/backend-api # View commits with author name containing 'Jack'\n```\n\nYou can always call `today --help` or `today -h` to view the default help at any time.\n\n### Flag Options\n\n* `--author` can be used to change which commits are displayed, based on a particular author.\n    * **The default is to display all authors.**\n    * This filter is done using [`strings.Contains`](https://pkg.go.dev/strings#Contains). As such, multiple authors may be displayed depending on the value provided.\n    * This allows you to filter for your own or someone else's commits.\n* `--colour` can be used to show a preset colourised output to the terminal. Directories which have no commits are shown in red, whilst others are highlighted in green.\n    * **The default is no colour.**\n* `--short` can be used to display only the first line of a commit.\n    * **The default is to display the entire commit message.**\n    * Useful when commit messages are incredibly descriptive, spanning below the fold to explain the intention of a change.\n    * This also has a side effect of reducing verbosity.\n* `--since` can be used to modify the time range.\n    * **The default is 12 hours, given in the format of 12h00m00s**.\n    * Valid time units must conform to [`time.ParseDuration`](https://pkg.go.dev/time#ParseDuration).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdockerty%2Ftoday","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjdockerty%2Ftoday","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdockerty%2Ftoday/lists"}