https://github.com/joecummings/gitmine
A command-line tool that makes it easier to track and manage Issues/PRs across multiple Github repositories.
https://github.com/joecummings/gitmine
github github-cli productivity
Last synced: about 19 hours ago
JSON representation
A command-line tool that makes it easier to track and manage Issues/PRs across multiple Github repositories.
- Host: GitHub
- URL: https://github.com/joecummings/gitmine
- Owner: joecummings
- License: mit
- Created: 2020-07-24T22:56:30.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2025-06-10T08:49:23.000Z (10 months ago)
- Last Synced: 2026-03-15T22:51:41.188Z (12 days ago)
- Topics: github, github-cli, productivity
- Language: Python
- Homepage:
- Size: 109 KB
- Stars: 15
- Watchers: 1
- Forks: 1
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.com/joecummings/gitmine)
# gitmine
Stop getting buried under countless Github Issues and PRs. Organize, reference, and close with ease.
Based on the amazing work done by Github itself on [hub](https://github.com/github/hub) and [Github CLI](https://cli.github.com/) (released while we were working on this project. Must've been on to something). I view this as a natural extension of the `gh` command for easy access to Issues and PRs from anywhere in your command line.
#### Who is this for?
I work on a lot of projects across many repositories. It was a pain in the a$$ to keep track of all the Issues I was assigned and PRs I had to review. Some tools provided a quick way to see Issues from one repository, but I needed a quick way to view, organize and open from any of these projects, thus `gitmine` was born.
If you aren't a heavy user of Github or maybe only have one repository you focus on, this is probably more than you need.
## Usage
### Command Line Arguments
```
Usage: gitmine [OPTIONS] COMMAND [ARGS]...
Simple command-line tool for querying assigned Issues and PR reviews from
Github.
Options:
-v, --verbose Give more output. Option is additive, and can be used up to
three times.
--help Show this message and exit.
Commands:
config Set or Access Github Config information.
get Get assigned Github Issues and/or Github PRs.
go Open a browser page for the given repositiory / issue.
```
### Config
If you already have the Github CLI installed and setup, congrats! You can skip this section. `gitmine` automatically piggy-backs on Github CLI's config to access your Github information.
To use `gitmine` you will first need to generate a Personal Access Token. You can follow the instructions [here](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token).
```
gitmine config username ~git-username~
gitmine config token ~git-token~
```
## Installation
#### From PyPi
```
pip install gitmine
```
#### From source
```
pip install 'git+https://github.com/joecummings/gitmine.git'
```
## Contributing
See [Contributing.md](Contributing.md)
## Common Errors and FAQ's
* Running `gitmine get prs` with the wrong username will not error but return nothing