gitsome

Enter the gitsome shell (optional), to enable autocompletion and interactive help for Git (and gh) commands

$ gitsome

$ gh configure

$ gh notifications

$ gh starred "[python 3]"

$ gh feed [tldr-pages/tldr]

$ gh feed [torvalds] -p

gitsome
gitsome [--help | --version]
gitsome [command] [args...]

--help
    Displays a help message and exits.

--version
    Shows the installed gitsome version and exits.

gitsome is an interactive Git shell designed to enhance your command-line Git and GitHub workflow. It acts as a wrapper around the standard git command, providing powerful features like comprehensive auto-completion for Git commands and their arguments, intelligent GitHub API integration, and custom utilities. Instead of directly executing Git commands, you launch gitsome to enter an interactive shell where you can type your usual git commands, along with specialized gh commands for GitHub interactions and gs commands for gitsome-specific functions. This environment significantly boosts productivity by reducing typing errors, providing context-aware suggestions, and streamlining interactions with your remote repositories on GitHub, all within a familiar terminal interface. It aims to make your Git and GitHub experience more efficient and enjoyable.

gitsome requires Python 2.7 or 3.x to run. Its GitHub-specific features (gh commands) necessitate authentication with the GitHub API, typically via a personal access token, which can be configured using the gh login command within the shell. While highly functional, the project has seen limited active maintenance since 2020, which might impact future compatibility or feature development.

Within the gitsome shell, commands prefixed with gh allow direct interaction with the GitHub API. Examples include gh repos to list repositories, gh issues to view issues, or gh login to authenticate with GitHub. This significantly streamlines common GitHub tasks directly from the terminal.

Commands prefixed with gs are exclusive to gitsome, providing utilities beyond standard Git or GitHub operations. For instance, gs config allows managing gitsome's configuration, and gs cheat can display Git cheatsheets. These commands enhance the interactive experience by offering quick access to help and settings.

gitsome's behavior can be customized via a configuration file located at ~/.gitsome/config. This file allows users to define aliases, modify color schemes, set default behaviors, and manage GitHub credentials, enabling a highly personalized workflow.

gitsome was created by Donnie Margolis and first released in 2016. Its development was driven by the desire to provide a more interactive and user-friendly command-line experience for Git, particularly for those frequently interacting with GitHub. It aimed to merge the power of Git's CLI with the convenience of an interactive shell, drawing inspiration from tools like ipython. The project gained recognition for its innovative approach to Git and GitHub integration, offering features that were not natively available in the standard Git command line at the time.

git(1), hub(1), python(1), bash(1), zsh(1)