gem-contribute

gem-contribute is a command-line tool designed to help users identify open issues in the Ruby gems their projects already depend on. " This approach is intended to encourage contributions to projects that users are already familiar with, rather than searching broadly across all open-source repositories.

The tool provides a range of commands to streamline the contribution workflow. Users can initialize the tool with an interactive setup that configures a clone root and authenticates with GitHub using OAuth device flow. Once set up, commands allow users to list open issues for individual gems, iterate through all gems in the lockfile to find those with open issues, and drill down into specific projects. Additional commands support forking and cloning repositories, creating branches for issue fixes, and submitting pull requests by opening a pre-filled compare page in the browser. User configuration is managed via a YAML file in the home directory, with preferences such as clone location, preferred labels, and editor settings.

Authentication is handled through GitHub’s OAuth device flow, requiring only public_repo scope to enable forking, cloning, and reading public issues. The tool caches authentication tokens securely and provides commands to log in, check token status, and log out. While the current implementation focuses on GitHub, the architecture is designed to support additional hosts such as GitLab in future versions.

gem-contribute is maintained by cdhagmann and is distributed under the MIT license. Installation is available via RubyGems, and the tool is intended for developers seeking to contribute to the open-source Ruby gems they already use.