jlevy/ghizmo is a developer-focused project on GitHub with 89 stars, written primarily in Python. The missing command line for GitHub
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
GitHub's APIs
are exceptionally powerful, but the friction to using them can be a bit high.
You have to look up which library is best,
then write code to use that library,
spending time on trial and error with setup, authentication, etc.
Once you get something working, the result is probably not a reusable script without additional effort.
Ghizmo lets you do complex things with the GitHub APIs from the command line,
so you can automate reading, creating, or managing GitHub
repos, contributor statistics, pull requests, teams, etc.
Its JSON output is modeled directly off the APIs,
and can be piped into other tools.
It's also easy to add, save, and share more commands you perform frequently,
by putting them into a simple ghizmo_commands.py file,
and they become automatically available.
Essentially, it's just a harness around the clean and complete github3.py library.
It differs from the standard option hub in that it's not focusing key features to augment the git command.
Rather, it's a way to use the full GitHub APIs more easily.
(Also, since it's in Python, not Go, it can be extended without a compile step.)
Examples
Commands are all defined here and below.
Run ghizmo --help for a list of commands -- and see below on how to add new commands.
Commands can take arguments.
This command lists teams, and requires an organization name
(should you forget an argument required by a command, you'll be rudely advised of your oversight):
Another command of interest may be assemble-authors.
It looks at GitHub history and creates an AUTHORS.md file, also including role information and additional configurable headers and footers. See this example.
Installation
Requires Python 3.6+. Then (with sudo if desired):
pip install ghizmo
Ghizmo benefits if git is in your path so it can auto-detect your repository config.
You may also want to install tools like
jq or data_hacks
so you can perform operations such as the ones above that process JSON outputs.
Configuration
You can supply username and password from the command line, but you probably want to be able to use APIs without typing your
password. To do this, create a ~/.ghizmo.yml file:
# Ghizmo configuration
# Default GitHub login name:
username: my-github-id
# Personal access token for the above GitHub account:
access_token: aaaaaaaaaabbbbbbbbbbbccccccccc1234567890
Create an access token on your GitHub settings page to use with Ghizmo.
Custom commands
To add a new command, create a file ghizmo_commands.py in your current directory.
For example, here is one that counts pull requests by user:
import ghizmo.commands.lib as lib
from collections import defaultdict
def count_prs(config, args):
"""
Show tallies of pull requests by author login name.
"""
counts = defaultdict(int)
for pr in config.repo.pull_requests(state="closed"):
counts[pr.user.login] += 1
yield { "status": "I'm at PR %s!" % pr.number }
yield counts
def octotech_create_repo(config, args):
"""
If you like, your command can be custom, e.g. to your organization.
This creates a repo within your org owned by a specific team.
"""
org = config.github.organization("OctoTech")
team_id = 1234567890 # OctoTech engineering team
repo = org.create_repository(args.name, description=args.description, private=True,
has_issues=False, has_wiki=False, team_id=team_id)
Now running
ghizmo count-prs
(note the dash) will stream JSON messages as it tallies,
then write a tally of closed PRs for each user.
To use the second command, you need to specify custom arguments:
ghizmo octotech-create-repo -a name=ninth-leg -a description="Yet another repository!"
Convenience
The idea here is both to provide simple commands, but also to allow more custom or complex use.
You can easily save/commit commands you write to ghizmo_commands.py file to Git,
and your teammates can then use the same commands.
This means you can automate setup and configuration of GitHub repositories, teams, etc. in a flexible way.
If there're generally useful, please submit a PR and I'll gladly merge it for use by everyone.
Maturity
Mostly a one-day hack. Could be extended a lot, but seems to work.
Contributing
Yes, please!
We need more commands in the library.
File issues for bugs or general discussion.
No homepage URL was recorded for jlevy/ghizmo in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How active is development on jlevy/ghizmo?
The most recent commit recorded on jlevy/ghizmo was 2.6 years ago, based on the GitHub push timestamp. The repository has 15 forks — one of the better signals of community interest.
How many stars does jlevy/ghizmo have?
jlevy/ghizmo has 89 GitHub stars — refresh the page for the live number, or check github.com/jlevy/ghizmo. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is jlevy/ghizmo open source?
Yes — jlevy/ghizmo ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/jlevy/ghizmo.
What else is in the Developer Tools space?
jlevy/ghizmo is tracked by TopGit under the Developer Tools category, alongside 3 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What topics is jlevy/ghizmo associated with?
GitHub's repository topics for jlevy/ghizmo: "command-line", "github", "python". TopGit's editorial category is Developer Tools.
Where do I read more about jlevy/ghizmo?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/jlevy/ghizmo is the definitive source.
Read full README in the tab above.
Curious whether ghizmo is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about ghizmo.