gitsome
Enhance the Git command line experience
TLDR
Enter the gitsome shell (optional), to enable autocompletion and interactive help for Git (and gh) commands
Setup GitHub integration with the current account
List notifications for the current account (as would be seen in
List the current account's starred repos, filtered by a given search string
View the recent activity feed of a given GitHub repository
View the recent activity feed for a given GitHub user, using the default pager (e.g. less)
SYNOPSIS
No standalone binary; install & activate via:
curl -sL https://git.io/gitsome | sh
Then source ~/.gitsome/gitsome.plugin.sh in shell config.
PARAMETERS
GITSOME_THEME
Set custom prompt theme (e.g., 'default', 'powerline')
GITSOME_NO_ASYNC
Disable asynchronous Git status checks for compatibility
GITSOME_NO_GITTIME
Hide relative time since last commit in prompt
DESCRIPTION
gitsome is a popular open-source shell enhancement tool that provides a beautiful, informative prompt theme and advanced tab autocompletion specifically optimized for Git workflows. Developed for bash and zsh, it displays real-time Git repository status in your prompt, including branch name, current commit SHA, ahead/behind counts, uncommitted changes, and stash status. The prompt is color-coded for quick visual feedback: green for clean repos, red for dirty states.
Beyond the prompt, gitsome offers lightning-fast autocompletion for thousands of Git commands, subcommands, aliases, remotes, branches, and files. Completions are context-aware and fetched asynchronously to avoid shell lag. It's lightweight, with minimal overhead even in large repos.
Installation is simple: run curl -sL https://git.io/gitsome | sh, which clones the repo to ~/.gitsome and appends a source line to your .bashrc or .zshrc. Restart your shell or source the config to activate. Customization is via environment variables like GITSOME_THEME or GITSOME_NO_ASYNC. Though the project is archived, it remains widely used and compatible with modern shells and Git versions.
CAVEATS
Project archived since 2019; no active maintenance. May conflict with other prompt themes like Oh My Zsh's git plugin. Requires Git & curl installed.
CUSTOMIZATION
Edit ~/.gitsome/gitsome.plugin.sh or set env vars in shell profile. Themes: default, lean, powerline. Supports VCS like Mercurial.
UNINSTALL
rm -rf ~/.gitsome; edit shell config to remove source line.
HISTORY
Created by Scott Rogers in 2017 as a faster alternative to git-prompt.sh. Gained popularity for speed and features; archived on GitHub Mar 2019 after 6k+ stars. Forked/maintained indirectly via community.
