{"id":13870105,"url":"https://github.com/kevinjalbert/github_contributions","last_synced_at":"2025-03-26T22:30:33.939Z","repository":{"id":43471888,"uuid":"463367031","full_name":"kevinjalbert/github_contributions","owner":"kevinjalbert","description":"Gem that provides can fetch your GitHub contributions and output them.","archived":false,"fork":false,"pushed_at":"2022-03-01T02:17:45.000Z","size":15,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-22T14:22:07.413Z","etag":null,"topics":["gem","github","github-contributions","ruby"],"latest_commit_sha":null,"homepage":"https://rubygems.org/gems/github_contributions","language":"Ruby","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/kevinjalbert.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-25T02:13:51.000Z","updated_at":"2024-03-07T18:29:37.000Z","dependencies_parsed_at":"2022-08-20T10:11:11.150Z","dependency_job_id":null,"html_url":"https://github.com/kevinjalbert/github_contributions","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjalbert%2Fgithub_contributions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjalbert%2Fgithub_contributions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjalbert%2Fgithub_contributions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjalbert%2Fgithub_contributions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevinjalbert","download_url":"https://codeload.github.com/kevinjalbert/github_contributions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245747393,"owners_count":20665782,"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":["gem","github","github-contributions","ruby"],"created_at":"2024-08-05T20:01:28.821Z","updated_at":"2025-03-26T22:30:33.637Z","avatar_url":"https://github.com/kevinjalbert.png","language":"Ruby","readme":"# GitHub Contributions\n\n\u003e Ever wanted to know where you (or someone else) are making contributions on GitHub?\n\nYour GitHub profile shows you the [Contributions Calendar](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/viewing-contributions-on-your-profile#contributions-calendar) and [Contribution activity](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-graphs-on-your-profile/viewing-contributions-on-your-profile#contribution-activity), which both provide great visualizations and details covering contributions of the following:\n\n  - creating/closing issues\n  - creating/closing/merging/reviewing pull requests\n  - creating repositories\n  - authoring commits on the main branch of repositories\n  - starting/answering discussions\n\nI personally wanted to track comments on issues and pull requests as I felt they were a good indication of contributions. It sometimes isn't uncommon for a lot of discussions to happen on issues or even a pull request.\n\nI am a fan of [Obsidian](https://obsidian.md/) right now to track my day at work. Recording these contributions in GitHub makes it simple to recall what I did in previous days/weeks. This is even more important if you have a [_BragDoc_](https://jvns.ca/blog/brag-documents/). As Obsidian uses Markdown, that is the primary format that this tool is built for.\n\n## Install\n\n```bash\ngem install github_contributions\n```\n\nYou need a GitHub Personal Access Token in your ENVs as `GITHUB_ACCESS_TOKEN` for this gem to work.\n\n## Usage\n\n```bash\n# Show me contributions for 'kevinjalbert' for today\ngithub_contributions -a \"kevinjalbert\"\n\n# Show me contributions for 'kevinjalbert' for today only in the 'shopify' org\ngithub_contributions -a \"kevinjalbert\" -o \"shopify\"\n\n# Show me contributions for 'kevinjalbert' in the last week\ngithub_contributions -a \"kevinjalbert\" -s \"last week\"\n\n# Show me contributions for 'kevinjalbert' for the week before last\ngithub_contributions -a \"kevinjalbert\" -s \"two weeks ago\" -e \"one week ago\"\n\n# Show me contributions for 'kevinjalbert' for only yesterday\ngithub_contributions -a \"kevinjalbert\" -s \"yesterday\" -e \"yesterday\"\n\n# Help\ngithub_contributions -h\n```\n\nContributions are grouped by their pull request or issue in order of creation time. This ends up producing a rather detailed list of where contributions were made in the specified time frame. Links are present to easily allow you to jump directly to the contribution. Everything is displayed in Markdown, ready to be copy/pasted where desired. The following is an example of what the output looks like:\n\n- [Support function in `message` expectation in `t.throws` / `t.throwsAsync`](https://github.com/avajs/ava/issues/2978) by [sindresorhus](https://github.com/sindresorhus)\n  - [Issue Opened at 2022-02-26 08:42:19 UTC](https://github.com/avajs/ava/issues/2978)\n  - [IssueComment Created at 2022-02-26 08:43:12 UTC](https://github.com/avajs/ava/issues/2978#issuecomment-1051842838)\n- [Use `for..of` loop](https://github.com/sindresorhus/string-width/pull/40) by [fisker](https://github.com/fisker)\n  - [PullRequestReviewComment Created at 2022-02-28 08:18:52 UTC](https://github.com/sindresorhus/string-width/pull/40#discussion_r815662489)\n  - [PullRequestReview Created at 2022-02-28 08:18:52 UTC](https://github.com/sindresorhus/string-width/pull/40#pullrequestreview-894766255)\n  - [PullRequest Closed at 2022-02-28 08:20:12 UTC](https://github.com/sindresorhus/string-width/pull/40)\n  - [IssueComment Created at 2022-02-28 08:20:16 UTC](https://github.com/sindresorhus/string-width/pull/40#issuecomment-1054001902)\n","funding_links":[],"categories":["Ruby"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinjalbert%2Fgithub_contributions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinjalbert%2Fgithub_contributions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinjalbert%2Fgithub_contributions/lists"}